從 .NET 11 開始,由 ManagementClass.GetStronglyTypedClassCode 產生的強型別 WMI 集合包裝器及其列舉器會實作 IDisposable。 呼叫 Dispose() 會以確定性的方式釋放包裝的 ManagementObjectCollection 或 ManagementObjectCollection.ManagementObjectEnumerator 及其底層的 COM 支援 WMI 資源。
所推出的版本
.NET 11 RC 2
以前的行為
所 GetStronglyTypedClassCode 輸出的集合型別與列舉器型別並未實作 IDisposable。 產生的集合無法用於 using 語句中,消費者也無法確定性地釋放其包裝 ManagementObjectCollection 或列舉器所持有的 WMI 資源。
// The generated ServiceCollection type did not implement IDisposable.
Service.ServiceCollection services = Service.GetInstances();
新行為
產生的集合型與列舉型別實作 IDisposable。 消費者可以處置它們,以確定性地釋放底層的 WMI 資源。
using Service.ServiceCollection services = Service.GetInstances();
foreach (Service item in services)
{
// Use item.
}
由於產生的包裝類別是非封存的,加入 IDisposable 可能會影響那些衍生自產生的包裝類別,且已宣告 Dispose 成員或實作自身處置模式的程式碼。
破壞性變更的類型
變更原因
生成的包裝器持有以 COM 為基礎的 WMI 資源。 此變更揭露了已包裝的 System.Management 型別所支援的處置行為,讓消費者能確定性地釋放這些資源。 包裝型別的終結器備用方式保持不變。 更多資訊請參見 dotnet/runtime#132587。
建議的動作
用更新後的產生器重新生成強型別的 WMI 包裝器。 當產生的集合與列舉封裝器不再需要時,則處置這些封裝器,最好是用 using 或 using var。
如果你的程式碼源自產生的集合或列舉器封裝器,且已經定義了銷毀模式,請檢視該生成型態的新 IDisposable 實作。 更新衍生型別以避免成員 Dispose 衝突,並保留對自身資源與基底包裝器資源的釋放(dispose)。