Code-Beispiel
Ein Beispiel zum Einsatz der Klasse System.Management.ManagementObject aus der .NET-Klassenbibliothek.
Autor: Dr. Holger Schwichtenberg
Beschreibung
Die Klasse Management.ManagementObject ist die Meta-Klasse für ein einzelnes WMI-Objekt. Bei der Instanziierung wird über den Konstruktor ein WMI-Pfad angegeben, der die Instanz der Meta-Klasse an ein bestimmtes WMI-Objekt bindet.
Beispiel
Das folgende Beispiel zeigt das Auslesen von Eigenschaften des Laufwerks "C", das durch eine Instanz der WMI-Klasse Win32_LogicalDisk in WMI abgebildet wird. Diese Instanz wird durch folgenden WMI-Pfad eindeutig identifiziert:
\root\cimv2:Win32_LogicalDisk.DeviceID='C:'
Bei der Instanziierung wird eine Instanz der Meta-Klasse Management.ManagementObject mit Namen mo an das obige WMI-Objekt gebunden:
mo = New Management.ManagementObject(PFAD)
Mit dem Meta-Objektmodell ist ein direkter Zugriff nur auf die Mitglieder des Meta-Objekts möglich, also auf die Mitglieder von mo. Die Klasse Management.ManagementObject enthält selbst keine Daten, sondern nur Verweise auf Unterobjekte. So führt das Attribut Path zu einem Objekt des Typs ManagementPath, das allgemeine Informationen über das WMI-Objekt wie z.B. den relativen Pfad, den Computer, auf dem das Objekt liegt, und den WMI-Klassennamen liefert.
out("Computer: " & mo.Path.Server)
Die Attribute des WMI-Objekts (also die Eigenschaften des Laufwerks in diesem Beispiel) kann man nur über String-Parameter ansprechen:
out("Name: " & mo("Caption"))
out("FileSystem: " & mo("FileSystem"))
out("Freie Bytes: " & System.Convert.ToUInt32(mo("FreeSpace")).ToString
Das folgende Listing zeigt das komplette Beispiel.
Programmcodebeispiele Visual Basic .NET (VB.NET)
' ============================
' .NET-Code-Beispiel in Visual Basic .NET
' Zugriff auf ein bestimmtes WMI-Objekt
' (C) Holger@Schwichtenberg.de
' ============================
Sub wmi_mo1()
Const PFAD = _
"\root\cimv2:Win32_LogicalDisk.DeviceID='C:'"
Dim mo As Management.ManagementObject
' --- Zugriff auf WMI-Objekt
mo = New Management.ManagementObject(PFAD)
' --- Attribute des Meta-Objekts
out("-- Metainformation:")
out("kompletter WMI-Pfad:" & _
mo.Path.Path)
out("Relativer Pfad:" & _
mo.Path.RelativePath)
out("Computer: " & _
mo.Path.Server)
out("Namespace:" & _
mo.Path.NamespacePath)
out("Standardpfad: " & _
mo.Path.DefaultPath.Path)
out("Klassenname: " & _
mo.Path.ClassName)
' --- Attribute des WMI-Objekts
out("-- Zugriff auf einzelne Attribute")
out("Name: " & mo("Caption"))
out("Dateisystem: " & mo("FileSystem"))
out("Freie Bytes: " & System.Convert.ToUInt32(mo("FreeSpace")).ToString)
End Sub
Programmcodebeispiele CSharp (C#)
using System;
using System.Management;
namespace FCLBuch._SystemManagement {
public class SamplesWMIAllgemein {
public void WMI_ManagementObject1() {
// Zugriff auf ein bestimmtes Managed Object
string pfad = @"\root\cimv2:Win32_LogicalDisk.DeviceID='C:'";
// Zugriff auf Managed Object
ManagementObject mo = new ManagementObject(pfad);
// Attribute des Meta-Objekts
FclOutput.PrintOutSubHeader("Metainformation:");
FclOutput.PrintOut("kompletter WMI-Pfad:" + mo.Path.Path);
FclOutput.PrintOut("Relativer Pfad:" + mo.Path.RelativePath);
FclOutput.PrintOut("Computer: " + mo.Path.Server);
FclOutput.PrintOut("Namespace:" + mo.Path.NamespacePath);
FclOutput.PrintOut("Standardpfad: " + ManagementPath.DefaultPath.Path);
FclOutput.PrintOut("Klassenname: " + mo.Path.ClassName);
// Attribute des Managed Objects
FclOutput.PrintOutSubHeader("Zugriff auf einzelne Attribute");
FclOutput.PrintOut("Name: " + mo["Caption"]);
FclOutput.PrintOut("Dateisystem: " + mo["FileSystem"]);
FclOutput.PrintOut("Freie Bytes: " + Convert.ToUInt32(mo["FreeSpace"]).ToString());
}
}
}
Hinweise
Ausgaben werden in den Beispielen durch Hilfsroutinen wie out() und
PrintOut() erzeugt. Diese sind hier nicht angegeben, da deren Implementierung
von der jeweiligen Umgebung abhängt. Für Konsolenanwendungen können hier z.B.
Console.WriteLine() einsetzen.
Querverweise
Liste aller Codebeispiele
Definition '.NET Framework Class Library'
Verfügbarkeit der Klasse 'System.Management.ManagementObject'
Übersicht über den FCL-Namensraum 'System.Management'
.NET & Visual Studio Community Portal