Mgmtclassgen.exe (管理強類型類別產生器)

[管理強類型類別產生器] 工具可快速地為指定的 Windows Management Instrumentation (WMI) 類別產生早期繫結 Managed 類別。 產生的類別會將為存取 WMI 類別之執行個體所撰寫的程式碼加以簡化。

語法

mgmtclassgen
WMIClass [options]

備註

Mgmtclassgen.exe 會使用 ManagementClass.GetStronglyTypedClassCode 方法。 因此，您可以使用任何自訂程式碼提供者來產生 Managed 語言 (不是 C#、Visual Basic 和 JScript) 的程式碼。

請注意，產生的類別會繫結至為其所產生的結構描述。 當基礎結構描述改變時，若要反映結構描述的這些改變就必須重新產生類別。

下表顯示 WMI 通用訊息模型 (Common Information Model，CIM) 類型如何對應至所產生類別中的資料類型：

請注意下列在產生 WMI 類別時的行為：

• 標準公用屬性或方法有可能和現有屬性或方法的名稱相同。 當此情況發生時，工具會變更在所產生之類別中屬性或方法的名稱以避免命名衝突。

• 所產生之類別中屬性或方法的名稱有可能是目標程式語言的關鍵字。 當此情況發生時，工具會變更在所產生之類別中屬性或方法的名稱以避免命名衝突。

• 在 WMI 中，限定詞為修飾詞，其中包含說明類別、執行個體、屬性或方法的資訊。 WMI 使用如 Read、Write 和 Key 等標準限定詞以說明產生之類別中的屬性。 例如，以 Read 限定詞修飾的屬性只能以在所產生類別中的屬性 get 存取子來定義。 因為以 Read 限定詞標記的屬性是做唯讀之用，不會定義 set 存取子。

• 數值屬性可使用 Values 和 ValueMaps 限定詞加以修飾，表示屬性只能設定為指定的允許值。 列舉是以這些 Values 和 ValueMaps 產生的，而屬性會對應到列舉。

• WMI 使用單一 (Singleton) 這個詞彙來說明只能有一個執行個體的類別。 因此，單一 (Singleton) 類別的無參數建構函式會將類別初始化為該類別的唯一執行個體。

• WMI 類別可以擁有物件的屬性。 當您為這種類型的 WMI 類別產生強型別類別時，您應該考慮為內嵌物件屬性的類型產生強型別類別。 這可讓您以強型別的方式存取內嵌物件。 請注意，產生的程式碼可能無法偵測內嵌物件的類型。 在這個情況下，會在產生的程式碼中建立註解以告知您這個問題。 接著，您可以將所產生程式碼的屬性類型修改為其他所產生類別的屬性類型。

• WMI 中，CIM_DATETIME 資料類型的資料值可表示特定的日期和時間，或表示時間間隔。 如果資料值代表日期和時間，所產生類別中的資料類型就會是 DateTime。 如果資料值代表時間間隔，則所產生類別中的資料類型就會是 TimeSpan。

您也可以使用 Visual Studio .NET 中的 [伺服器總管管理延伸模組] 來產生強型別類別。

如需 WMI 的詳細資訊，請參閱 Platform SDK 說明文件中的 Windows Management Instrumentation 主題。

範例

下列命令會在 Root\cimv2 命名空間中產生 Win32_LogicalDisk WMI 類別的 Managed 類別 (以 C# 程式碼撰寫)。 工具會將 Managed 類別寫入 c:\disk.cs 的原始程式檔，放在 ROOT.CIMV2.Win32 命名空間中。

mgmtclassgen Win32_LogicalDisk /n root\cimv2 /l CS /p c:\disk.cs  

下列程式碼範例顯示如何以程式設計方式使用產生的類別。 首先，列舉類別的執行個體並印出路徑。 接下來，以 WMI 的執行個體建立要初始化所產生類別的執行個體。 Process 是為 Win32_Process 產生的類別，LogicalDisk 則是為 Root\cimv2 命名空間中 Win32_LogicalDisk 產生的類別。

Imports System  
Imports System.Management  
Imports ROOT.CIMV2.Win32  
  
Public Class App
   Public Shared Sub Main()
      ' Enumerate instances of the Win32_process.  
      ' Print the Name property of the instance.  
      Dim ps As Process
      For Each ps In  Process.GetInstances()  
         Console.WriteLine(ps.Name)  
      Next ps  
  
      ' Initialize the instance of LogicalDisk with  
      ' the WMI instance pointing to logical drive d:.  
      Dim dskD As New LogicalDisk(New _  
         ManagementPath("win32_LogicalDisk.DeviceId=""d:"""))  
      Console.WriteLine(dskD.Caption)  
   End Sub  
End Class  

using System;  
using System.Management;  
using ROOT.CIMV2.Win32;  
  
public class App  
{  
   public static void Main()  
   {  
      // Enumerate instances of the Win32_process.  
      // Print the Name property of the instance.  
      foreach(Process ps in Process.GetInstances())  
      {  
         Console.WriteLine(ps.Name);  
      }  
  
      // Initialize the instance of LogicalDisk with  
      // the WMI instance pointing to logical drive d:.  
      LogicalDisk dskD = new LogicalDisk(new ManagementPath(  
        "win32_LogicalDisk.DeviceId=\"d:\""));  
      Console.WriteLine(dskD.Caption);  
   }  
}  

另請參閱

• System.Management
• ManagementClass.GetStronglyTypedClassCode
• System.CodeDom.Compiler.CodeDomProvider
• 工具
• 開發人員命令列殼層