Mgmtclassgen.exe (Management Strongly Typed Class Generator)

Lo strumento Generatore di classi di gestione fortemente tipizzate consente di generare velocemente una classe gestita ad associazione precoce per una specifica classe WMI (Windows Management Instrumentation, Strumentazione gestita Windows). L'utilizzo della classe generata semplifica la scrittura del codice per l'accesso a un'istanza della classe WMI.

Sintassi

mgmtclassgen
WMIClass [options]

Osservazioni:

Mgmtclassgen.exe utilizza il metodo ManagementClass.GetStronglyTypedClassCode. È possibile pertanto utilizzare un provider di codice personalizzato per generare codice in linguaggi gestiti diversi da C#, Visual Basic e JScript.

Le classi generate sono associate allo schema per il quale sono state generate. Quando lo schema sottostante una classe viene modificato è necessario generare nuovamente la classe se si desidera che essa rispecchi le modifiche dello schema.

Nella tabella riportata di seguito viene illustrato il mapping tra i tipi CIM (Common Information Model) WMI e i tipi dati inclusi in una classe generata.

Quando viene generata una classe WMI può accadere quanto segue:

• Una proprietà o un metodo pubblico standard può avere lo stesso nome di una proprietà o di un metodo esistente. In tal caso il nome della proprietà o del metodo nella classe generata verrà automaticamente cambiato per evitare conflitti di denominazione.

• Il nome di una proprietà o di un metodo in una classe generata può essere una parola chiave nel linguaggio di programmazione di destinazione. In tal caso il nome della proprietà o del metodo nella classe generata verrà automaticamente cambiato per evitare conflitti di denominazione.

• In WMI un qualificatore è un modificatore contenente informazioni per descrivere una classe, un'istanza, una proprietà o un metodo. Per descrivere una proprietà in una classe generata, WMI usa qualificatori standard quali Read, Write e Key. Ad esempio, una proprietà modificata con il qualificatore Read viene definita solo con una funzione di accesso get della proprietà nella classe generata. Poiché una proprietà contrassegnata dal qualificatore Read è di sola lettura, non viene definita alcuna funzione di accesso set.

• Una proprietà numerica può essere modificata tramite i qualificatori Values e ValueMaps per indicare che la proprietà può essere impostata solo su specifici valori consentiti. Viene generata un'enumerazione con i qualificatori Values e ValueMaps e viene eseguito il mapping della proprietà all'enumerazione.

• La strumentazione WMI utilizza il termine Singleton per descrivere una classe che può avere una sola istanza. Il costruttore senza parametri per una classe singleton, pertanto, inizializzerà la classe per l'unica istanza della classe.

• Le proprietà di una classe WMI possono essere oggetti. Quando si genera una classe fortemente tipizzata per questo tipo di classe WMI, è consigliabile generare classi fortemente tipizzate per i tipi delle proprietà degli oggetti incorporati. In questo modo sarà possibile accedere agli oggetti incorporati in modo fortemente tipizzato. Il codice generato potrebbe non essere in grado di individuare il tipo dell'oggetto incorporato. In tal caso nel codice generato verrà creato un commento che notifica il problema. Sarà quindi possibile modificare il codice generato per tipizzare la proprietà sull'altra classe generata.

• In WMI il valore dei dati del tipo di dati CIM_DATETIME può rappresentare una specifica data e ora o un intervallo di tempo. Se il valore dei dati rappresenta una data e un'ora, il tipo di dati nella classe generata è DateTime. Se il valore dei dati rappresenta un intervallo di tempo, il tipo di dati nella classe generata è TimeSpan.

In alternativa, è possibile generare una classe fortemente tipizzata usando l'estensione di gestione esplora server in Visual Studio .NET.

Per altre informazioni su WMI, vedere l'argomento Windows Management Instrumentation (Strumentazione gestione Windows (WMI)) nella documentazione di Platform SDK.

Esempi

Il comando seguente genera una classe gestita in codice C# per la classe WMI Win32_LogicalDisk nello spazio dei nomi Root\cimv2. Lo strumento scrive la classe gestita nel file di origine che si trova nel percorso c:\disk.cs dello spazio dei nomi ROOT.CIMV2.Win32.

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

Nel codice di esempio riportato di seguito viene illustrato come utilizzare una classe generata a livello di programmazione. Innanzitutto viene enumerata un'istanza della classe e viene visualizzato il percorso. In seguito, un'istanza della classe generata da inizializzare viene creata con un'istanza di WMI. Process è la classe generata per Win32_Process e LogicalDisk è la classe generata per Win32_LogicalDisk nello spazio dei nomi 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);  
   }  
}  

Vedi anche

• System.Management
• ManagementClass.GetStronglyTypedClassCode
• System.CodeDom.Compiler.CodeDomProvider
• Strumenti
• Shell della riga di comando per sviluppatori