ManagementPath Class

Definition

Namespace:

System.Management

Assembly:

System.Management.dll

Package:

System.Management v9.0.0

Source:

ManagementPath.cs

Provides a wrapper for parsing and building paths to WMI objects.

public ref class ManagementPath : ICloneable

[System.ComponentModel.TypeConverter(typeof(System.Management.ManagementPathConverter))]
public class ManagementPath : ICloneable

[<System.ComponentModel.TypeConverter(typeof(System.Management.ManagementPathConverter))>]
type ManagementPath = class
    interface ICloneable

Public Class ManagementPath
Implements ICloneable

Inheritance

Object

ManagementPath

Attributes

TypeConverterAttribute

Implements

ICloneable

Examples

The following example demonstrates how the ManagementPath class parses a path to a WMI object. The path that is parsed in the example is a path to an instance of a class.

using System;
using System.Management;

public class Sample
{
    public static void Main()
    {

        // Get the WMI class path
        ManagementPath p =
            new ManagementPath(
            "\\\\ComputerName\\root" +
            "\\cimv2:Win32_LogicalDisk.DeviceID=\"C:\"");

        Console.WriteLine("IsClass: " +
            p.IsClass);
        // Should be False (because it is an instance)

        Console.WriteLine("IsInstance: " +
            p.IsInstance);
        // Should be True

        Console.WriteLine("ClassName: " +
            p.ClassName);
        // Should be "Win32_LogicalDisk"

        Console.WriteLine("NamespacePath: " +
            p.NamespacePath);
        // Should be "ComputerName\cimv2"

        Console.WriteLine("Server: " +
            p.Server);
        // Should be "ComputerName"

        Console.WriteLine("Path: " +
            p.Path);
        // Should be "ComputerName\root\cimv2:
        // Win32_LogicalDisk.DeviceId="C:""

        Console.WriteLine("RelativePath: " +
            p.RelativePath);
        // Should be "Win32_LogicalDisk.DeviceID="C:""
    }
}

Imports System.Management


Public Class Sample
    Public Overloads Shared Function _
        Main(ByVal args() As String) As Integer

        ' Get the WMI class path
        Dim p As ManagementPath = _
            New ManagementPath( _
            "\\ComputerName\root" & _
            "\cimv2:Win32_LogicalDisk.DeviceID=""C:""")

        Console.WriteLine("IsClass: " & _
            p.IsClass)
        ' Should be False (because it is an instance)

        Console.WriteLine("IsInstance: " & _
            p.IsInstance)
        ' Should be True

        Console.WriteLine("ClassName: " & _
            p.ClassName)
        ' Should be "Win32_LogicalDisk"

        Console.WriteLine("NamespacePath: " & _
            p.NamespacePath)
        ' Should be "ComputerName\cimv2"

        Console.WriteLine("Server: " & _
            p.Server)
        ' Should be "ComputerName"

        Console.WriteLine("Path: " & _
            p.Path)
        ' Should be "ComputerName\root\cimv2:
        ' Win32_LogicalDisk.DeviceId="C:""

        Console.WriteLine("RelativePath: " & _
            p.RelativePath)
        ' Should be "Win32_LogicalDisk.DeviceID="C:""

    End Function
End Class

Constructors

ManagementPath()	Initializes a new instance of the ManagementPath class that is empty. This is the parameterless constructor.
ManagementPath(String)	Initializes a new instance of the ManagementPath class for the given path.

Properties

ClassName	Gets or sets the class portion of the path.
DefaultPath	Gets or sets the default scope path used when no scope is specified. The default scope is \\.\root\cimv2, and can be changed by setting this property.
IsClass	Gets or sets a value indicating whether this is a class path.
IsInstance	Gets or sets a value indicating whether this is an instance path.
IsSingleton	Gets or sets a value indicating whether this is a singleton instance path.
NamespacePath	Gets or sets the namespace part of the path. Note that this does not include the server name, which can be retrieved separately.
Path	Gets or sets the string representation of the full path in the object.
RelativePath	Gets or sets the relative path: class name and keys only.
Server	Gets or sets the server part of the path.

Methods

Clone()	Returns a copy of the ManagementPath.
Equals(Object)	Determines whether the specified object is equal to the current object. (Inherited from Object)
GetHashCode()	Serves as the default hash function. (Inherited from Object)
GetType()	Gets the Type of the current instance. (Inherited from Object)
MemberwiseClone()	Creates a shallow copy of the current Object. (Inherited from Object)
SetAsClass()	Sets the path as a new class path. This means that the path must have a class name but not key values.
SetAsSingleton()	Sets the path as a new singleton object path. This means that it is a path to an instance but there are no key values.
ToString()	Returns the full object path as the string representation.

Explicit Interface Implementations

ICloneable.Clone()

Creates a new object that is a copy of the current instance.