Mgmtclassgen.exe (генератор строго типизированных классов управления)

Генератор классов управления со строгим типом позволяет быстро создавать управляемые классы с ранней привязкой для указанного класса инструментария управления Windows (WMI). Создаваемый класс снижает сложность кода, необходимого для доступа к экземпляру класса WMI.

Это средство устанавливается автоматически с Visual Studio и пакетом SDK Windows. Чтобы запустить инструмент, мы рекомендуем использовать командную строку Visual Studio или командную строку пакета Windows SDK (командную оболочку). Эти служебные программы позволяют легко работать с инструментом, не переходя к папке установки. Дополнительные сведения см. в разделе Командная строка 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 Common Information Model (CIM) и типов данных создаваемых классов.

Отметим следующие особенности процесса создания классов WMI:

• Стандартное открытое свойство или метод может иметь имя, совпадающее с именем существующего свойства или метода. В этом случае программа изменит имя свойства или метода в создаваемом классе, чтобы избежать конфликта имен.

• Стандартное свойство или метод создаваемого класса может иметь имя, совпадающее с зарезервированным словом используемого языка программирования. В этом случае программа изменит имя свойства или метода в создаваемом классе, чтобы избежать конфликта имен.

• В WMI квалификаторами называются модификаторы, которые содержат информацию, описывающую класс, экземпляр, свойство или метод. WMI использует для описания свойств создаваемого класса стандартные квалификаторы, такие как Read, Write, и Key. Так, свойство, измененное квалификатором Read, определяется только совместно с методом get доступа к этому свойству в создаваемом классе. Поскольку свойство, помеченное квалификатором Read, предназначено только для чтения, метод set не определяется.

• Числовые свойства могут быть модифицированы при помощи квалификаторов Values и ValueMaps , которые показывают, что свойство может принимать только указанные допустимые значения. Перечисление создается на основе этих элементов Values и ValueMaps, а свойство сопоставляется с этим перечислением.

• Класс, который может иметь только один экземпляр, называется в WMI "одиночкой" (англ. singleton). Таким образом, конструктор класса-одиночки по умолчанию инициализирует класс в единственном экземпляре.

• Свойства класса WMI могут быть объектами. При создании класса со строгим типом для данного типа класса WMI следует по возможности создавать классы со строгими типами для типов его внедренных свойств-объектов. Благодаря этому станет возможен доступ к внедренным объектам в режиме строгой типизации. Следует заметить, что создаваемый код не всегда может определить тип внедренных объектов. В этом случае в созданном коде будет создан комментарий с уведомлением об этой ситуации. Обнаружив такое уведомление, следует модифицировать созданный код, приписав свойство другому созданному классу.

• В WMI значение данных типа CIM_DATETIME может быть представлено как в виде определенной даты и времени, так и в виде временного интервала. Если значение представляет собой время и дату, в созданном классе ему будет соответствовать класс DateTime. Если значение представляет собой временной интервал, в созданном классе ему будет соответствовать класс TimeSpan.

Управляемые классы со строгим типом можно создавать также при помощи Server Explorer Management Extension в Visual Studio .NET.

Дополнительные сведения о WMI см. в разделе Инструментарий управления Windows документации по продукту Platform SDK.

Примеры

Следующая команда создает управляемый класс на языке C# для класса Win32_LogicalDisk в пространстве имен Root\cimv2. Программа записывает управляемый класс в исходный файл c:\disk.cs в пространстве имен ROOT.CIMV2.Win32.

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

Следующий пример кода показывает, как использовать созданный класс в программе. Сначала экземпляр класса перечисляется и печатается путь к нему. Затем создается экземпляр инициализируемого класса с экземпляром WMI. Process – это класс, созданный для процесса Win32, и LogicalDisk – это класс, созданный для Win32_LogicalDisk в пространстве имен Root\cimv2.

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

Журнал изменений