Mgmtclassgen.exe（管理强类型类生成器）

更新：2011 年 4 月

管理强类型类生成器工具使您可为指定的 Windows Management Instrumentation (WMI) 类快速生成早期绑定的托管类。 生成的类简化了为访问 WMI 类的实例所必须编写的代码。

安装 Visual Studio 和 Windows SDK 时会自动安装此工具。 要运行工具，我们建议您使用 Visual Studio 命令提示符或 Windows SDK 命令提示符（也称 CMD Shell）。 您可以使用这些实用程序轻松运行工具，而不需要导航到安装文件夹。 有关更多信息，请参见 Visual Studio 和 Windows SDK 命令提示。

• 如果您的计算机上已安装了 Visual Studio：在任务栏上依次单击 Start、All Programs、Visual Studio、Visual Studio Tools、Visual Studio Command Prompt。

  - 或 -

  如果您的计算机上已安装了 Windows SDK：在任务栏上依次单击 Start、All Programs、Windows SDK 文件夹和 Command Prompt（或CMD Shell)。

• 在命令提示处，键入下列命令：

mgmtclassgen WMIClass [options] 

备注

Mgmtclassgen.exe 使用 ManagementClass.GetStronglyTypedClassCode 方法。 因此，您可使用任何自定义的代码提供程序以 C#、Visual Basic 和 JScript 以外的托管语言生成代码。

注意，生成的代码绑定到为其生成代码的架构。 如果基础架构发生更改，并且您希望该类反映架构的更改，则必须重新生成该类。

下表显示 WMI 通用信息模型 (CIM) 类型映射到生成的类中的数据类型的方式：

生成 WMI 类时请注意以下行为：

• 标准公共属性或方法可能与现有属性或方法具有相同的名称。 如果出现这种情况，则该工具会更改生成的类中的属性或方法的名称，以避免命名冲突。

• 生成的类中的属性或方法的名称可能是目标编程语言的关键字。 如果出现这种情况，则该工具会更改生成的类中的属性或方法的名称，以避免命名冲突。

• 在 WMI 中，限定符是包含描述类、实例、属性或方法的信息的修饰符。 WMI 使用标准限定符（如 Read、Write 和 Key）描述生成的类中的属性。 例如，生成的类中用 Read 限定符修饰的属性只能定义属性 get 访问器。 因为用 Read 限定符标记的属性将是只读的，所以未定义 set 访问器。

• 可用 Values 和 ValueMaps 限定符来修饰数值型属性，以指出仅可将该属性设置为指定的允许值。 一个具有这些 Values 和 ValueMaps 的枚举将会生成，该属性映射为该枚举。

• WMI 使用单一实例 (singleton) 这个术语描述只能有一个实例的类。 因此，单一实例类的默认构造函数将该类初始化为该类的唯一实例。

• WMI 类可以有对象类型的属性。 为这一类型的 WMI 类生成强类型类时，应考虑为嵌入式对象属性的类型生成强类型类。 这使您能以强类型方式访问嵌入式对象。 注意生成的代码可能无法检测嵌入对象的类型。 这种情况下，生成的代码中将创建一条注释，以通知您存在此问题。 然后可修改生成的代码，以将该属性的类型转换为其他生成类的类型。

• 在 WMI 中，CIM_DATETIME 数据类型的数据值可表示某一特定的日期和时间或时间间隔。 若数据值表示日期和时间，则生成的类的数据类型为 DateTime。 若数据值表示时间间隔，则生成的类的数据类型为 TimeSpan。

也可使用 Visual Studio .NET 的服务器资源管理器管理扩展生成强类型的类。

有关 WMI 的更多信息，请参见 Platform SDK 文档中的 Windows Management Instrumentation 主题。

示例

以下命令为 Root\cimv2 命名空间中的 Win32_LogicalDisk WMI 类生成 C# 托管类。 该工具将 ROOT.CIMV2.Win32 命名空间中的托管类写到位于 c:\disk.cs 的源文件中。

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

Visual Studio 和 Windows SDK 命令提示

其他资源

.NET Framework 工具

修订记录