ManagementObject Constructors

Reference

Definition

Namespace:: System.Management

Assembly:: System.Management.dll

Package:: System.Management v9.0.0

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Initializes a new instance of the ManagementObject class.

Overloads

ManagementObject()	Initializes a new instance of the ManagementObject class. This is the parameterless constructor.
ManagementObject(ManagementPath)	Initializes a new instance of the ManagementObject class for the specified WMI object path. The path is provided as a ManagementPath.
ManagementObject(String)	Initializes a new instance of the ManagementObject class for the specified WMI object path. The path is provided as a string.
ManagementObject(ManagementPath, ObjectGetOptions)	Initializes a new instance of the ManagementObject class bound to the specified WMI path, including the specified additional options.
ManagementObject(SerializationInfo, StreamingContext)	Obsolete. Initializes a new instance of the ManagementObject class that is serializable.
ManagementObject(String, ObjectGetOptions)	Initializes a new instance of the ManagementObject class bound to the specified WMI path, including the specified additional options. In this variant, the path can be specified as a string.
ManagementObject(ManagementScope, ManagementPath, ObjectGetOptions)	Initializes a new instance of the ManagementObject class bound to the specified WMI path that includes the specified options.
ManagementObject(String, String, ObjectGetOptions)	Initializes a new instance of the ManagementObject class bound to the specified WMI path, and includes the specified options. The scope and the path are specified as strings.

ManagementObject()

Source:: ManagementObject.cs

Source:: ManagementObject.cs

Source:: ManagementObject.cs

Initializes a new instance of the ManagementObject class. This is the parameterless constructor.

public:
 ManagementObject();

public ManagementObject ();

Public Sub New ()

Examples

The following example initializes a new instance of the ManagementObject class with the parameterless constructor.

using System;
using System.Management;

class Sample
{
    public static int Main(string[] args)
    {
        ManagementObject o = new ManagementObject();

        // Now set the path on this object to
        // bind it to a 'real' manageable entity
        o.Path =
            new ManagementPath("Win32_LogicalDisk='c:'");

        //Now it can be used
        Console.WriteLine(o["FreeSpace"]);

        return 0;
    }
}

Imports System.Management

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

        Dim o As New ManagementObject

        Dim mp As New _
            ManagementPath("Win32_LogicalDisk='c:'")

        ' Now set the path on this object to
        ' bind it to a 'real' manageable entity
        o.Path = mp

        'Now it can be used 
        Console.WriteLine(o("FreeSpace"))

        Return 0
    End Function
End Class

Remarks

.NET Framework Security

Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.

Applies to

ManagementObject(ManagementPath)

Source:: ManagementObject.cs

Source:: ManagementObject.cs

Source:: ManagementObject.cs

Initializes a new instance of the ManagementObject class for the specified WMI object path. The path is provided as a ManagementPath.

public:
 ManagementObject(System::Management::ManagementPath ^ path);

public ManagementObject (System.Management.ManagementPath path);

new System.Management.ManagementObject : System.Management.ManagementPath -> System.Management.ManagementObject

Public Sub New (path As ManagementPath)

Parameters

path: ManagementPath

A ManagementPath that contains a path to a WMI object.

Examples

The following example initializes a new instance of the ManagementObject class with a specified WMI object path.

using System;
using System.Management;

class Sample
{
    public static int Main(string[] args)
    {
        ManagementPath p =
            new ManagementPath(
            "Win32_Service.Name='Alerter'");
        ManagementObject o = new ManagementObject(p);

        //Now it can be used
        Console.WriteLine(o["Name"]);

        return 0;
    }
}

Imports System.Management

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

        Dim p As New ManagementPath( _
            "Win32_Service.Name=""Alerter""")
        Dim o As New ManagementObject(p)

        'Now it can be used 
        Console.WriteLine(o("Name"))

        Return 0
    End Function
End Class

Remarks

.NET Framework Security

Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.

Applies to

ManagementObject(String)

Source:: ManagementObject.cs

Source:: ManagementObject.cs

Source:: ManagementObject.cs

Initializes a new instance of the ManagementObject class for the specified WMI object path. The path is provided as a string.

public:
 ManagementObject(System::String ^ path);

public ManagementObject (string path);

new System.Management.ManagementObject : string -> System.Management.ManagementObject

Public Sub New (path As String)

Parameters

path: String

A WMI path.

Examples

The following example initializes a new instance of the ManagementObject class.

using System;
using System.Management;

class Sample
{
    public static int Main(string[] args)
    {
        ManagementObject o =
            new ManagementObject("Win32_Service.Name='Alerter'");

        //or with a full path :

        ManagementObject mObj =
            new ManagementObject(
            "\\\\MyServer\\root\\MyApp:MyClass.Key='abc'");

        return 0;
    }
}

Imports System.Management

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

        Dim o As New ManagementObject( _
    "Win32_Service.Name=""Alerter""")

        ' or with a full path :

        Dim mObj As New ManagementObject( _
            "\\\\MyServer\\root\\MyApp:MyClass.Key=""abc""")

        Return 0
    End Function
End Class

Remarks

If the specified path is a relative path only (a server or namespace is not specified), the default path is the local machine, and the default namespace is the DefaultPath path (by default, root\cimv2). If the user specifies a full path, the default settings are overridden.

.NET Framework Security

Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.

Applies to

ManagementObject(ManagementPath, ObjectGetOptions)

Source:: ManagementObject.cs

Source:: ManagementObject.cs

Source:: ManagementObject.cs

Initializes a new instance of the ManagementObject class bound to the specified WMI path, including the specified additional options.

public:
 ManagementObject(System::Management::ManagementPath ^ path, System::Management::ObjectGetOptions ^ options);

public ManagementObject (System.Management.ManagementPath path, System.Management.ObjectGetOptions options);

new System.Management.ManagementObject : System.Management.ManagementPath * System.Management.ObjectGetOptions -> System.Management.ManagementObject

Public Sub New (path As ManagementPath, options As ObjectGetOptions)

Parameters

path: ManagementPath

A ManagementPath containing the WMI path.

options: ObjectGetOptions

An ObjectGetOptions containing additional options for binding to the WMI object. This parameter could be null if default options are to be used.

Examples

The following example initializes a new instance of the ManagementObject class that is bound to a specific WMI path.

using System;
using System.Management;

class Sample
{
    public static int Main(string[] args)
    {
        ManagementPath p =
            new ManagementPath("Win32_Service");

        // Set options for no context info
        // but requests amended qualifiers
        // to be contained in the object
        ObjectGetOptions opt =
            new ObjectGetOptions(
            null, System.TimeSpan.MaxValue, true);

        ManagementClass c =
            new ManagementClass(p, opt);

        Console.WriteLine(
            c.Qualifiers["Description"].Value);

        return 0;
    }
}

Imports System.Management

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

        Dim p As New ManagementPath("Win32_Service")

        ' Set options for no context info
        ' but requests amended qualifiers 
        ' to be contained in the object
        Dim opt As New ObjectGetOptions( _
            Nothing, TimeSpan.MaxValue, True)

        Dim c As New ManagementClass(p, opt)

        Console.WriteLine(c.Qualifiers("Description").Value)

        Return 0
    End Function
End Class

Remarks

.NET Framework Security

Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.

Applies to

ManagementObject(SerializationInfo, StreamingContext)

Source:: ManagementObject.cs

Source:: ManagementObject.cs

Source:: ManagementObject.cs

Caution

This API supports obsolete formatter-based serialization. It should not be called or extended by application code.

Initializes a new instance of the ManagementObject class that is serializable.

protected:
 ManagementObject(System::Runtime::Serialization::SerializationInfo ^ info, System::Runtime::Serialization::StreamingContext context);

public:
 ManagementObject(System::Runtime::Serialization::SerializationInfo ^ info, System::Runtime::Serialization::StreamingContext context);

[System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
protected ManagementObject (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);

public ManagementObject (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);

protected ManagementObject (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);

[<System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
new System.Management.ManagementObject : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> System.Management.ManagementObject

new System.Management.ManagementObject : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> System.Management.ManagementObject

Protected Sub New (info As SerializationInfo, context As StreamingContext)

Public Sub New (info As SerializationInfo, context As StreamingContext)

Parameters

info: SerializationInfo

The SerializationInfo to populate with data.

context: StreamingContext

The destination (see StreamingContext) for this serialization.

Attributes: ObsoleteAttribute

Remarks

.NET Framework Security

Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.

Applies to

ManagementObject(String, ObjectGetOptions)

Source:: ManagementObject.cs

Source:: ManagementObject.cs

Source:: ManagementObject.cs

Initializes a new instance of the ManagementObject class bound to the specified WMI path, including the specified additional options. In this variant, the path can be specified as a string.

public:
 ManagementObject(System::String ^ path, System::Management::ObjectGetOptions ^ options);

public ManagementObject (string path, System.Management.ObjectGetOptions options);

new System.Management.ManagementObject : string * System.Management.ObjectGetOptions -> System.Management.ManagementObject

Public Sub New (path As String, options As ObjectGetOptions)

Parameters

path: String

The WMI path to the object.

options: ObjectGetOptions

An ObjectGetOptions representing options to get the specified WMI object.

Examples

The following example initializes a new instance of the ManagementObject class.

using System;
using System.Management;

class Sample
{
    public static int Main(string[] args)
    {
        // Set options for no context info,
        // but requests amended qualifiers
        // to be contained in the object
        ObjectGetOptions opt =
            new ObjectGetOptions(null, System.TimeSpan.MaxValue, true);

        ManagementObject o =
            new ManagementObject(
            "Win32_Service", opt);

        Console.WriteLine(o.GetQualifierValue("Description"));

        return 0;
    }
}

Imports System.Management

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

        ' Set options for no context info, 
        ' but requests amended qualifiers
        ' to be contained in the object
        Dim opt As New ObjectGetOptions( _
            Nothing, System.TimeSpan.MaxValue, True)

        Dim o As New ManagementObject( _
            "Win32_Service", opt)

        Console.WriteLine(o.GetQualifierValue("Description"))

        Return 0
    End Function
End Class

Remarks

.NET Framework Security

Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.

Applies to

ManagementObject(ManagementScope, ManagementPath, ObjectGetOptions)

Source:: ManagementObject.cs

Source:: ManagementObject.cs

Source:: ManagementObject.cs

Initializes a new instance of the ManagementObject class bound to the specified WMI path that includes the specified options.

public:
 ManagementObject(System::Management::ManagementScope ^ scope, System::Management::ManagementPath ^ path, System::Management::ObjectGetOptions ^ options);

public ManagementObject (System.Management.ManagementScope scope, System.Management.ManagementPath path, System.Management.ObjectGetOptions options);

new System.Management.ManagementObject : System.Management.ManagementScope * System.Management.ManagementPath * System.Management.ObjectGetOptions -> System.Management.ManagementObject

Public Sub New (scope As ManagementScope, path As ManagementPath, options As ObjectGetOptions)

Parameters

scope: ManagementScope

A ManagementScope representing the scope in which the WMI object resides. In this version, scopes can only be WMI namespaces.

path: ManagementPath

A ManagementPath representing the WMI path to the manageable object.

options: ObjectGetOptions

An ObjectGetOptions specifying additional options for getting the object.

Examples

The following example initializes a new instance of the ManagementObject class that is bound to a specific WMI path.

using System;
using System.Management;

class Sample
{
    public static int Main(string[] args)
    {
        ManagementScope s = new ManagementScope(
            "\\\\MyMachine\\root\\cimv2");
        ManagementPath p =
            new ManagementPath(
            "Win32_Service");

        // Set options for no context info,
        // but requests amended qualifiers
        // to be contained in the object
        ObjectGetOptions opt =
            new ObjectGetOptions(
            null, TimeSpan.MaxValue, true);

        ManagementObject o = new ManagementObject(s, p, opt);

        Console.WriteLine(o.Qualifiers["Description"].Value);

        return 0;
    }
}

Imports System.Management

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

        Dim s As New ManagementScope( _
            "\\MyMachine\root\cimv2")
        Dim p As New ManagementPath( _
            "Win32_Service")

        ' Set options for no context info,
        ' but requests amended qualifiers 
        ' to be contained in the object
        Dim opt As ObjectGetOptions
        opt = New ObjectGetOptions( _
                Nothing, TimeSpan.MaxValue, True)

        Dim o As ManagementObject
        o = New ManagementObject(s, p, opt)

        Console.WriteLine(o.Qualifiers("Description").Value)

        Return 0
    End Function
End Class

Remarks

Because WMI paths can be relative or full, a conflict between the scope and the path specified may arise. However, if a scope is specified and a relative WMI path is specified, then there is no conflict. The following are some possible conflicts:

If a scope is not specified and a relative WMI path is specified, then the scope will default to the local machine's DefaultPath.

If a scope is not specified and a full WMI path is specified, then the scope will be inferred from the scope portion of the full path. For example, the full WMI path: \\MyMachine\root\MyNamespace:MyClass.Name='abc' will represent the WMI object 'MyClass.Name='abc'" in the scope '\\MyMachine\root\MyNamespace'.

If a scope is specified and a full WMI path is specified, then the scope will override the scope portion of the full path. For example, if the following scope was specified: \\MyMachine\root\MyScope, and the following full path was specified: \\MyMachine\root\MyNamespace:MyClass.Name='abc', then look for the following object: \\MyMachine\root\MyScope:MyClass.Name= 'abc' (the scope part of the full path is ignored).

.NET Framework Security

Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.

Applies to

ManagementObject(String, String, ObjectGetOptions)

Source:: ManagementObject.cs

Source:: ManagementObject.cs

Source:: ManagementObject.cs

Initializes a new instance of the ManagementObject class bound to the specified WMI path, and includes the specified options. The scope and the path are specified as strings.

public:
 ManagementObject(System::String ^ scopeString, System::String ^ pathString, System::Management::ObjectGetOptions ^ options);

public ManagementObject (string scopeString, string pathString, System.Management.ObjectGetOptions options);

new System.Management.ManagementObject : string * string * System.Management.ObjectGetOptions -> System.Management.ManagementObject

Public Sub New (scopeString As String, pathString As String, options As ObjectGetOptions)

Parameters

scopeString: String

The scope for the WMI object.

pathString: String

The WMI object path.

options: ObjectGetOptions

An ObjectGetOptions representing additional options for getting the WMI object.

Examples

The following example initializes a new instance of the ManagementObject class with a specific WMI path and options.

using System;
using System.Management;

class Sample
{
    public static int Main(string[] args)
    {
        ObjectGetOptions opt =
            new ObjectGetOptions(null, System.TimeSpan.MaxValue, true);
        ManagementObject o =
            new ManagementObject(
            "root\\MyNamespace", "MyClass", opt);

        return 0;
    }
}

Imports System.Management

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

        Dim opt As New ObjectGetOptions( _
            Nothing, System.TimeSpan.MaxValue, True)
        Dim o As New ManagementObject( _
            "root\MyNamespace", "MyClass", opt)

        Return 0
    End Function
End Class

Remarks

See the equivalent overload for details.

.NET Framework Security

Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.

Applies to

Compartir a través de

ManagementObject Constructors

Definition

Overloads

ManagementObject()

Examples

Remarks

.NET Framework Security

Applies to

ManagementObject(ManagementPath)

Parameters

Examples

Remarks

.NET Framework Security

Applies to

ManagementObject(String)

Parameters

Examples

Remarks

.NET Framework Security

Applies to

ManagementObject(ManagementPath, ObjectGetOptions)

Parameters

Examples

Remarks

.NET Framework Security

Applies to

ManagementObject(SerializationInfo, StreamingContext)

Parameters

Remarks

.NET Framework Security

Applies to

ManagementObject(String, ObjectGetOptions)

Parameters

Examples

Remarks

.NET Framework Security

Applies to

ManagementObject(ManagementScope, ManagementPath, ObjectGetOptions)

Parameters

Examples

Remarks

.NET Framework Security

Applies to

ManagementObject(String, String, ObjectGetOptions)

Parameters

Examples

Remarks

.NET Framework Security

Applies to

Recursos adicionales