EnumerationOptions 类

定义

命名空间:

System.Management

程序集:

System.Management.dll

包:

System.Management v8.0.0

Source:

ManagementOptions.cs

为查询和枚举相关的选项对象提供基类。

public ref class EnumerationOptions : System::Management::ManagementOptions

public class EnumerationOptions : System.Management.ManagementOptions

type EnumerationOptions = class
    inherit ManagementOptions

Public Class EnumerationOptions
Inherits ManagementOptions

继承

Object

ManagementOptions

EnumerationOptions

示例

以下示例使用EnumerationOptions构造函数初始化EnumerationOptions变量，然后获取 WMI 类及其子类的所有实例。

using System;
using System.Management;
public class RemoteConnect
{
    public static void Main()
    {
        EnumerationOptions opt = new EnumerationOptions();
        // Will enumerate instances of the given class
        // and any subclasses.
        opt.EnumerateDeep = true;
        ManagementClass c = new ManagementClass("CIM_Service");
        foreach (ManagementObject o in c.GetInstances(opt))
            Console.WriteLine(o["Name"]);
    }
}

Imports System.Management
Public Class RemoteConnect

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

        Dim opt As New EnumerationOptions
        ' Will enumerate instances of the given class
        ' and any subclasses.
        opt.EnumerateDeep = True
        Dim mngmtClass As New ManagementClass("CIM_Service")
        Dim o As ManagementObject
        For Each o In mngmtClass.GetInstances(opt)
            Console.WriteLine(o("Name"))
        Next o

        Return 0
    End Function
End Class

构造函数

EnumerationOptions()	使用默认值（有关默认值的内容，请参见各属性的说明）初始化 EnumerationOptions 类的新实例。 这是无参数构造函数。
EnumerationOptions(ManagementNamedValueCollection, TimeSpan, Int32, Boolean, Boolean, Boolean, Boolean, Boolean, Boolean, Boolean)	初始化将用于查询或枚举的 EnumerationOptions 类的一个新实例，从而允许用户指定不同选项的值。

属性

BlockSize	获取或设置块操作的块大小。 在对整个集合进行枚举时，WMI 将按指定大小的组返回结果。
Context	获取或设置一个 WMI 上下文对象。 这是将传递给 WMI 提供程序的名称-值对列表，该提供程序支持自定义操作的上下文信息。 (继承自 ManagementOptions)
DirectRead	获取或设置一个值，该值指示是否为指定类请求直接访问 WMI 提供程序，而不考虑其超类或派生类。
EnsureLocatable	获取或设置一个值，该值指示返回的对象中是否应该有可定位信息。 这可确保系统属性（如“__PATH”、“__RELPATH”和“__SERVER”）非 null。 此标志只能用在查询中，而在枚举中会被忽略。
EnumerateDeep	获取或设置一个值，该值指示是否将递归枚举请求到从指定的超类派生的所有类中。 如果为 false，则仅返回直接派生类成员。
PrototypeOnly	获取或设置一个值，该值指示查询是否应返回结果集的原型而不返回实际结果。 此标志用于获取原型。
ReturnImmediately	获取或设置一个值，该值指示调用的操作应以同步方式或半同步方式执行。 如果此属性设置为 true，则会调用枚举，并且调用会立即返回。 遍历结果集合后，将出现实际的检索结果。
Rewindable	获取或设置一个值，该值指示是否将集合假定为可重绕。 如果为 true，则集合中的对象将保持以便用于多次枚举。 如果为 false，则只能将集合枚举一次。
Timeout	获取或设置要应用于该操作的超时。 注意，对于返回集合的操作，此超时将通过结果集合（而不是操作本身）应用于枚举（对于后面一种情况，应使用 ReturnImmediately 属性）。 此属性用来指示将以半同步方式执行操作。 (继承自 ManagementOptions)
UseAmendedQualifiers	获取或设置一个值，该值指示从 WMI 返回的对象是否应包含已修正信息。 通常，已修正信息就是附加在 WMI 对象上的可本地化信息，如对象和属性说明。

方法

Clone()	返回对象的一个副本。
Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetType()	获取当前实例的 Type。 (继承自 Object)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
ToString()	返回表示当前对象的字符串。 (继承自 Object)