在 .NET 11 中,內建的相依性注入容器會嘗試處置所有被擷取的可處置服務,即使某個服務拋出例外。 此行為適用於同步與非同步處置範圍及根服務提供者。 多次釋放失敗會產生 AggregateException。
所推出的版本
.NET 11
以前的行為
過去,範圍與根提供者的處置作業會以反向擷取順序處理已擷取的可處置服務,但在第一個例外處停止。 該例外未曾更改,其餘服務未被釋放。
例如,假設你解析了 FirstDisposable,然後解析了 SecondDisposable,而且這兩個服務在處置期間都擲回例外。 容器先棄置了 SecondDisposable。 其例外狀況阻止處置 FirstDisposable。
新行為
從 .NET 11 開始,內建範圍與根服務提供者的同步與非同步處置,會以反向擷取順序嘗試每個擷取的可處置服務,即使失敗後也是如此。
所有釋放嘗試結束後,會重新投出一個例外,且不更改。 若多個處置作業失敗,處置會拋出AggregateException AggregateException,其中包含所有例外。
在前述範例中,容器嘗試處置 SecondDisposable,然後處置 FirstDisposable。 因為兩者都會擲回例外,所以處置時會擲回一個包含這兩個例外的 AggregateException。
破壞性變更的類型
此變更為行為變更。
變更原因
為了讓每個已擷取的服務有機會釋放資源,例如計時器、事件處理程式和未受控控制代碼,容器在發生例外之後仍會繼續執行處置。 過去,某項服務的失敗會阻止其他服務釋放資源。
更多資訊請參閱 dotnet/runtime PR #123342。
建議的動作
如果你的處置實作不會擲回例外,且程式碼不依賴處置在第一次失敗後停止,則不需要採取任何行動。
為了避免清理失敗,請優先使用不會擲回例外的 Dispose() 和 DisposeAsync() 實作。 如果你的程式碼會處理處置失敗,請同時處理單一失敗的原始例外,以及多重失敗的 AggregateException。 在一般例外處理常式之前先捕捉 AggregateException,並檢查 InnerExceptions 以處理每一次失敗。
不要依賴處置例外來阻止其他服務被處置。 沒有任何相容性切換可還原先前的行為。
受影響的 API
- Microsoft.Extensions.DependencyInjection.ServiceProvider.Dispose()
- Microsoft.Extensions.DependencyInjection.ServiceProvider.DisposeAsync()
- Microsoft.Extensions.DependencyInjection.AsyncServiceScope.Dispose()
- Microsoft.Extensions.DependencyInjection.AsyncServiceScope.DisposeAsync()
- System.IDisposable.Dispose() 在內建容器所建立的 Microsoft.Extensions.DependencyInjection.IServiceScope 實例上。