ManagementObject 建構函式
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
初始化 ManagementObject 類別的新執行個體。
多載
ManagementObject() |
初始化 ManagementObject 類別的新執行個體。 這是無參數建構函式。 |
ManagementObject(ManagementPath) |
初始化指定 WMI 物件路徑的 ManagementObject 類別的新執行個體。 路徑會提供做為 ManagementPath。 |
ManagementObject(String) |
初始化指定 WMI 物件路徑的 ManagementObject 類別的新執行個體。 路徑會提供為字串。 |
ManagementObject(ManagementPath, ObjectGetOptions) |
初始化繫結到指定的 WMI 路徑 (包括指定的其他選項) 之 ManagementObject 類別的新執行個體。 |
ManagementObject(SerializationInfo, StreamingContext) |
已淘汰.
初始化可序列化之 ManagementObject 類別的新執行個體。 |
ManagementObject(String, ObjectGetOptions) |
初始化繫結到指定的 WMI 路徑 (包括指定的其他選項) 之 ManagementObject 類別的新執行個體。 在這項變數中,路徑可以指定為字串。 |
ManagementObject(ManagementScope, ManagementPath, ObjectGetOptions) |
初始化繫結至指定的 WMI 路徑 (包括指定的選項) 之 ManagementObject 類別的新執行個體。 |
ManagementObject(String, String, ObjectGetOptions) |
初始化繫結至指定的 WMI 路徑 (且包括指定的選項) 之 ManagementObject 類別的新執行個體。 範圍和路徑會指定為字串。 |
ManagementObject()
初始化 ManagementObject 類別的新執行個體。 這是無參數建構函式。
public:
ManagementObject();
public ManagementObject ();
Public Sub New ()
範例
下列範例會使用無參數建構函式,初始化 類別的新實例 ManagementObject 。
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
備註
.NET Framework 安全性
完全信任立即呼叫者。 這個成員無法供部分信任的程式碼使用。 如需詳細資訊,請參閱 使用部分信任程式代碼的連結庫。
適用於
ManagementObject(ManagementPath)
初始化指定 WMI 物件路徑的 ManagementObject 類別的新執行個體。 路徑會提供做為 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)
參數
- path
- ManagementPath
ManagementPath,含有通往 WMI 物件的路徑。
範例
下列範例會使用指定的 WMI 物件路徑,初始化 類別的新實例 ManagementObject 。
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
備註
.NET Framework 安全性
完全信任立即呼叫者。 這個成員無法供部分信任的程式碼使用。 如需詳細資訊,請參閱 使用部分信任程式代碼的連結庫。
適用於
ManagementObject(String)
初始化指定 WMI 物件路徑的 ManagementObject 類別的新執行個體。 路徑會提供為字串。
public:
ManagementObject(System::String ^ path);
public ManagementObject (string path);
new System.Management.ManagementObject : string -> System.Management.ManagementObject
Public Sub New (path As String)
參數
- path
- String
WMI 路徑。
範例
下列範例會初始化 類別的新實例 ManagementObject 。
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
備註
如果指定的路徑是僅 (未) 指定伺服器或命名空間的相對路徑,則預設路徑為本機計算機,而預設命名空間預設為 DefaultPath 路徑 (root\cimv2) 。 如果使用者指定完整路徑,則會覆寫預設設定。
.NET Framework 安全性
完全信任立即呼叫者。 這個成員無法供部分信任的程式碼使用。 如需詳細資訊,請參閱 使用部分信任程式代碼的連結庫。
適用於
ManagementObject(ManagementPath, ObjectGetOptions)
初始化繫結到指定的 WMI 路徑 (包括指定的其他選項) 之 ManagementObject 類別的新執行個體。
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)
參數
- path
- ManagementPath
ManagementPath,含有 WMI 路徑。
- options
- ObjectGetOptions
ObjectGetOptions,含有繫結到 WMI 物件的其他選項。 如果要採用預設的選項,這個參數可以是 Null。
範例
下列範例會初始化 系結至特定 WMI 路徑之 ManagementObject 類別的新實例。
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
備註
.NET Framework 安全性
完全信任立即呼叫者。 這個成員無法供部分信任的程式碼使用。 如需詳細資訊,請參閱 使用部分信任程式代碼的連結庫。
適用於
ManagementObject(SerializationInfo, StreamingContext)
警告
This API supports obsolete formatter-based serialization. It should not be called or extended by application code.
初始化可序列化之 ManagementObject 類別的新執行個體。
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}")]
protected ManagementObject (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);
public ManagementObject (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);
new System.Management.ManagementObject : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> System.Management.ManagementObject
[<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
Protected Sub New (info As SerializationInfo, context As StreamingContext)
Public Sub New (info As SerializationInfo, context As StreamingContext)
參數
- info
- SerializationInfo
要以資料填入的 SerializationInfo。
- context
- StreamingContext
這個序列化的目的端 (請參閱 StreamingContext)。
- 屬性
備註
.NET Framework 安全性
完全信任立即呼叫者。 這個成員無法供部分信任的程式碼使用。 如需詳細資訊,請參閱 使用部分信任程式代碼的連結庫。
適用於
ManagementObject(String, ObjectGetOptions)
初始化繫結到指定的 WMI 路徑 (包括指定的其他選項) 之 ManagementObject 類別的新執行個體。 在這項變數中,路徑可以指定為字串。
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)
參數
- path
- String
通往物件的 WMI 路徑。
- options
- ObjectGetOptions
ObjectGetOptions,表示取得指定 WMI 物件的選項。
範例
下列範例會初始化 類別的新實例 ManagementObject 。
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
備註
.NET Framework 安全性
完全信任立即呼叫者。 這個成員無法供部分信任的程式碼使用。 如需詳細資訊,請參閱 使用部分信任程式代碼的連結庫。
適用於
ManagementObject(ManagementScope, ManagementPath, ObjectGetOptions)
初始化繫結至指定的 WMI 路徑 (包括指定的選項) 之 ManagementObject 類別的新執行個體。
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)
參數
- scope
- ManagementScope
ManagementScope,表示 WMI 物件所在的範圍。 在這個版本中,範圍只能是 WMI 命名空間。
- path
- ManagementPath
ManagementPath,表示通往可管理物件的 WMI 路徑。
- options
- ObjectGetOptions
ObjectGetOptions,指定取得物件的其他選項。
範例
下列範例會初始化 系結至特定 WMI 路徑之 ManagementObject 類別的新實例。
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
備註
因為 WMI 路徑可以是相對路徑或完整路徑,所以可能會發生範圍與指定路徑之間的衝突。 不過,如果指定範圍並指定相對 WMI 路徑,則不會發生衝突。 以下是一些可能的衝突:
如果未指定範圍並指定相對 WMI 路徑,則範圍預設為本機電腦的 DefaultPath。
如果未指定範圍,而且指定了完整的 WMI 路徑,則會從完整路徑的範圍部分推斷範圍。 例如,完整的 WMI 路徑: \\MyMachine\root\MyNamespace:MyClass.Name='abc'
將會代表範圍 『\\MyMachine\root\MyNamespace』 中的 WMI 物件 'MyClass.Name='abc'。
如果指定範圍並指定完整的 WMI 路徑,則範圍將會覆寫完整路徑的範圍部分。 例如,如果指定了下列範圍:\\MyMachine\root\MyScope,且指定了下列完整路徑:\\MyMachine\root\MyNamespace:MyClass.Name='abc',則) 忽略完整路徑的範圍部分,請尋找下列 object: \\MyMachine\root\MyScope:MyClass.Name= 'abc'
(。
.NET Framework 安全性
完全信任立即呼叫者。 這個成員無法供部分信任的程式碼使用。 如需詳細資訊,請參閱 使用部分信任程式代碼的連結庫。
適用於
ManagementObject(String, String, ObjectGetOptions)
初始化繫結至指定的 WMI 路徑 (且包括指定的選項) 之 ManagementObject 類別的新執行個體。 範圍和路徑會指定為字串。
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)
參數
- scopeString
- String
WMI 物件的範圍。
- pathString
- String
WMI 物件路徑。
- options
- ObjectGetOptions
ObjectGetOptions,表示取得 WMI 物件的其他選項。
範例
下列範例會使用特定的 WMI 路徑和選項,初始化 類別的新實例 ManagementObject 。
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
備註
如需詳細資訊,請參閱對等的多載。
.NET Framework 安全性
完全信任立即呼叫者。 這個成員無法供部分信任的程式碼使用。 如需詳細資訊,請參閱 使用部分信任程式代碼的連結庫。