Gerenciamento Strongly Typed gerador de classe (mgmtclassgen.exe)

A ferramenta de gerenciamento gerador de classe digitados fortemente permite gerar rapidamente um early-limite gerenciado classe para uma classe de WMI (Instrumentação de gerenciamento do Windows) especificada. A classe gerada simplifica o código que deve escrever para acessar uma instância da classe WMI.

mgmtclassgen WMIClass [options] 

Comentários

Mgmtclassgen.exe usa o sistema.Management.ManagementClass.GetStronglyTypedClassCode método. Portanto, você pode usar qualquer provedor de código personalizado para gerar o código gerenciado idiomas Outros translation from VPE for Csharp, Visual Basic e JScript.

Observe que classes geradas são vinculados a esquema para o qual eles são gerados. Se o esquema subjacente for alterado, você deve regenerar a classe se desejar que ele para refletir as alterações no esquema.

A tabela a seguir mostra como tipos CIM (modelo de informação comum) do WMI são mapeados para tipos de dados em uma classe gerada:

Observe os seguintes comportamentos ao gerar uma classe WMI:

• É possível que uma propriedade pública padrão ou método para ter o mesmo nome de uma propriedade existente ou método. Se isso ocorrer, a ferramenta altera o nome da propriedade ou método na classe gerada para evitar conflitos de nomes.

• É possível que o nome de uma propriedade ou método em uma classe gerada para ser uma palavra-chave na linguagem de programação de destino. Se isso ocorrer, a ferramenta altera o nome da propriedade ou método na classe gerada para evitar conflitos de nomes.

• No WMI, qualificadores são modificadores que contêm informações para descrever uma classe, ocorrência, propriedade ou método. O WMI usa sistema autônomo qualificadores padrão sistema autônomo, por exemplo, Leitura, gravar, and Chave para descrever uma propriedade em uma classe gerada. Por exemplo, uma propriedade modificada com um Leitura qualificador é definido somente com uma propriedade obter acessador na classe gerada. Porque uma propriedade marcada com o Leitura qualificador deve ser somente leitura, um conjunto acessador não está definido.

• Uma propriedade numérica pode ser modificada pelo Valores and ValueMaps qualificadores para indicar que a propriedade pode ser definida somente ao especificados os valores permitidos. An Enumerações no CTS (Common Type System) é gerado com esses Valores and ValueMaps e a propriedade é mapeado para a enumeração.

• O WMI usa o termo singleton para descrever uma classe que pode ter apenas uma instância. Portanto, o construtor padrão para uma classe singleton inicializará a classe para a única instância da classe.

• Uma classe WMI pode ter propriedades que são objetos. Quando você gera uma classe fortemente tipado para este tipo de classe WMI, você deve considerar Gerando classes com rigidez de tipos para os tipos de propriedades do objeto incorporado. Isso permitirá que você acesse objetos incorporados de maneira fortemente tipado. Observe que o código gerado pode não ser capaz de detectar o tipo de objeto incorporado. Nesse caso, será criado um comentário no código gerado para notificá-lo desse problema. Em seguida, você pode modificar o código gerado para digitar a propriedade para a classe gerada.

• No WMI, o valor de dados do tipo de dados CIM_DATETIME pode representar uma determinada data e time ou um intervalo de time. Se o valor de dados representa uma data e time, o tipo de dados na classe gerado é DateTime. Se o valor de dados representa um intervalo de time, o tipo de dados na classe gerado é TimeSpan.

Como alternativa, você pode gerar uma classe fortemente tipado usando a extensão de gerenciamento do Gerenciador de Servidores no Visual Studio. NET.

Para obter mais informações sobre o Instrumentação de Gerenciamento do Windows, consulte o Windows Management instrumentação tópico na documentação do plataforma SDK.

Exemplos

O comando a seguir gera um gerenciado classe no código translation from VPE for Csharp o Win32_LogicalDisk classe WMI no raiz\cimv2 namespace. A ferramenta grava no arquivo de fonte em c:\disco.cs no classe gerenciadaraiz.CIMV2.Win32 namespace.

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

O exemplo de código a seguir mostra como usar uma classe gerada através de programação. Primeiro, uma instância da classe é enumerada e o caminho é impressa. Em seguida, é criar uma instância da classe gerada para serem inicializados com uma instância do WMI. Process a classe é gerada para Win32_Process and LogicalDisk a classe é gerada para Win32_LogicalDisk in the raiz\cimv2 namespace.

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);
   }
}

Consulte também

Referência

Ferramentas.NET Framework

System.Management

sistema.Management.ManagementClass.GetStronglyTypedClassCode

System.CodeDom.Compiler.CodeDomProvider

Prompt de comando SDK 

Outros recursos

Windows Management Instrumentation (WMI) in .NET Framework