EnumerationOptions Class

Definition

Предоставляет базовый класс для параметрических объектов, связанных с запросами и перечислениями.Provides a base class for query and enumeration-related options objects.

public ref class EnumerationOptions : System::Management::ManagementOptions
public class EnumerationOptions : System.Management.ManagementOptions
type EnumerationOptions = class
    inherit ManagementOptions
Public Class EnumerationOptions
Inherits ManagementOptions
Inheritance
EnumerationOptions

Examples

Следующий пример инициализирует переменную EnumerationOptions с помощью конструктора EnumerationOptions, а затем получает все экземпляры класса WMI и его подклассов.The following example initializes an EnumerationOptions variable with an EnumerationOptions constructor and then gets all the instances of a WMI class and its subclasses.

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

Constructors

EnumerationOptions()

Выполняет инициализацию нового экземпляра класса EnumerationOptions с заданными по умолчанию значениями (описание значений по умолчанию см. в описаниях отдельных свойств).Initializes a new instance of the EnumerationOptions class with default values (see the individual property descriptions for what the default values are). Это конструктор без параметров.This is the parameterless constructor.

EnumerationOptions(ManagementNamedValueCollection, TimeSpan, Int32, Boolean, Boolean, Boolean, Boolean, Boolean, Boolean, Boolean)

Выполняет инициализацию нового экземпляра класса EnumerationOptions, который можно использовать для запросов и перечислений, предоставляя пользователю возможность задавать значения для различных параметров.Initializes a new instance of the EnumerationOptions class to be used for queries or enumerations, allowing the user to specify values for the different options.

Properties

BlockSize

Получает или задает размер блока для блочных операций.Gets or sets the block size for block operations. Когда производится перечисление коллекции, WMI возвращает результаты группами заданного размера.When enumerating through a collection, WMI will return results in groups of the specified size.

Context

Получает или задает контекстный объект WMI.Gets or sets a WMI context object. Это список пар имя/значение, который необходимо передать поставщику WMI, поддерживающему контекстные сведения для настраиваемой операции.This is a name-value pairs list to be passed through to a WMI provider that supports context information for customized operation.

(Inherited from ManagementOptions)
DirectRead

Возвращает или задает значение, указывающее на запрос прямого доступа к поставщику WMI для заданного класса без учета его суперкласса и производных классов.Gets or sets a value indicating whether direct access to the WMI provider is requested for the specified class, without any regard to its super class or derived classes.

EnsureLocatable

Получает или задает значение, указывающее, что возвращаемые объекты должны содержать доступные сведения.Gets or sets a value indicating whether to the objects returned should have locatable information in them. Это позволяет обеспечить, что для таких свойств системы, как __PATH, __RELPATH и __SERVER, будут заданы непустые значения.This ensures that the system properties, such as __PATH, __RELPATH, and __SERVER, are non-NULL. Этот флаг можно использовать только в запросах, в перечислениях он не обрабатывается.This flag can only be used in queries, and is ignored in enumerations.

EnumerateDeep

Получает или задает значение, указывающее, запрашивается ли рекурсивное перечисление во всех производных классах заданного суперкласса.Gets or sets a value indicating whether recursive enumeration is requested into all classes derived from the specified superclass. Если false, то возвращаются только члены ближайшего производного класса.If false, only immediate derived class members are returned.

PrototypeOnly

Получает или задает значение, указывающее, должен ли запрос возвращать прототип набора результатов вместо фактических результатов.Gets or sets a value indicating whether the query should return a prototype of the result set instead of the actual results. Этот флаг используется для создания прототипов.This flag is used for prototyping.

ReturnImmediately

Получает или задает значение, определяющее выполнение вызванной операции в синхронном или полусинхронном режиме.Gets or sets a value indicating whether the invoked operation should be performed in a synchronous or semisynchronous fashion. Если для этого свойства задано значение true, то вызывается перечисление и сразу же происходит возврат вызова.If this property is set to true, the enumeration is invoked and the call returns immediately. Фактически результаты будут извлекаться при прохождении по результирующей коллекции.The actual retrieval of the results will occur when the resulting collection is walked.

Rewindable

Получает или задает значение, определяющее, допускается ли перемотка назад для многократного прохождения коллекции.Gets or sets a value indicating whether the collection is assumed to be rewindable. Если true, то объекты коллекции будут доступны для многократного перечисления.If true, the objects in the collection will be kept available for multiple enumerations. Если false, то перечисление коллекции может быть выполнено только один раз.If false, the collection can only be enumerated one time.

Timeout

Получает или задает время ожидания для операции.Gets or sets the time-out to apply to the operation. Обратите внимание, что для операций, возвращающих коллекции, это время ожидания применяется к перечислению, которое выполняется в результирующей коллекции, а не к самой операции (к операции применяется свойство ReturnImmediately).Note that for operations that return collections, this time-out applies to the enumeration through the resulting collection, not the operation itself (the ReturnImmediately property is used for the latter). Это свойство позволяет указать, что операция должна быть выполнена в полусинхронном режиме.This property is used to indicate that the operation should be performed semi-synchronously.

(Inherited from ManagementOptions)
UseAmendedQualifiers

Получает или задает значение, указывающее, что возвращаемые из WMI объекты должны включать измененные сведения.Gets or sets a value indicating whether the objects returned from WMI should contain amended information. Как правило, измененные сведения — это локализуемые сведения, связанные с объектом WMI, например, описания объектов или свойств.Typically, amended information is localizable information attached to the WMI object, such as object and property descriptions.

Methods

Clone()

Возвращает копию объекта.Returns a copy of the object.

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()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Inherited from Object)

Applies to