產生的 WMI 包裝器實作 IDisposable

從 .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)。

受影響的 API