EnumerationOptions Classe

Definição

Fornece uma classe base para consulta e objetos de opção relacionados à enumeração.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
Herança
EnumerationOptions

Exemplos

O exemplo a seguir inicializa EnumerationOptions uma variável com EnumerationOptions um construtor e, em seguida, obtém todas as instâncias de uma classe WMI e suas subclasses.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

Construtores

EnumerationOptions()

Inicializa uma nova instância da classe EnumerationOptions com valores padrão (consulte as descrições de propriedade individuais para quais são os valores padrão).Initializes a new instance of the EnumerationOptions class with default values (see the individual property descriptions for what the default values are). Esse é o construtor sem parâmetros.This is the parameterless constructor.

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

Inicializa uma nova instância da classe EnumerationOptions a ser usada para consultas ou enumerações, permitindo que o usuário especifique valores para as diferentes opções.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.

Propriedades

BlockSize

Obtém ou define o tamanho do bloco para operações de bloco.Gets or sets the block size for block operations. Ao enumerar por meio de uma coleção, o WMI retornará resultados em grupos do tamanho especificado.When enumerating through a collection, WMI will return results in groups of the specified size.

Context

Obtém ou define um objeto de contexto WMI.Gets or sets a WMI context object. Essa é uma lista de pares nome-valor a ser passada para um provedor WMI que dá suporte a informações de contexto para a operação personalizada.This is a name-value pairs list to be passed through to a WMI provider that supports context information for customized operation.

(Herdado de ManagementOptions)
DirectRead

Obtém ou define um valor que indica se o acesso direto ao provedor de WMI é solicitado para a classe especificada, sem qualquer relação com a superclasse ou as classes derivadas.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

Obtém ou define um valor que indica se os objetos retornados devem conter informações localizáveis.Gets or sets a value indicating whether to the objects returned should have locatable information in them. Isso garante que as propriedades do sistema, como __PATH, __RELPATH e __SERVER não sejam NULL.This ensures that the system properties, such as __PATH, __RELPATH, and __SERVER, are non-NULL. Esse sinalizador só pode ser usado em consultas e é ignorado em enumerações.This flag can only be used in queries, and is ignored in enumerations.

EnumerateDeep

Obtém ou define um valor que indica se a enumeração recursiva é solicitada em todas as classes derivadas da superclasse especificada.Gets or sets a value indicating whether recursive enumeration is requested into all classes derived from the specified superclass. Se false, somente os membros imediatos da classe derivada são retornados.If false, only immediate derived class members are returned.

PrototypeOnly

Obtém ou define um valor que indica se a consulta deve retornar um protótipo do conjunto de resultados em vez dos resultados reais.Gets or sets a value indicating whether the query should return a prototype of the result set instead of the actual results. Este sinalizador é usado para criação de protótipos.This flag is used for prototyping.

ReturnImmediately

Obtém ou define um valor que indica se a operação invocada deve ser executada de forma síncrona ou semissíncrona.Gets or sets a value indicating whether the invoked operation should be performed in a synchronous or semisynchronous fashion. Se essa propriedade for definida como true, a enumeração será invocada e a chamada será retornada imediatamente.If this property is set to true, the enumeration is invoked and the call returns immediately. A recuperação real dos resultados ocorrerá quando a coleção resultante for percorrida.The actual retrieval of the results will occur when the resulting collection is walked.

Rewindable

Obtém ou define um valor que indica se a coleção pode ser retrocedida.Gets or sets a value indicating whether the collection is assumed to be rewindable. Se true, os objetos na coleção serão mantidos disponíveis para várias enumerações.If true, the objects in the collection will be kept available for multiple enumerations. Se false, a coleção só poderá ser enumerada uma vez.If false, the collection can only be enumerated one time.

Timeout

Obtém ou define o tempo limite para aplicar a operação.Gets or sets the time-out to apply to the operation. Observe que, para operações que retornam coleções, esse tempo limite se aplica à enumeração por meio da coleção resultante, não da operação propriamente dita (a propriedade ReturnImmediately é usada para a operação).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). Essa propriedade é usada para indicar que a operação deve ser realizada de forma semissíncrona.This property is used to indicate that the operation should be performed semi-synchronously.

(Herdado de ManagementOptions)
UseAmendedQualifiers

Obtém ou define um valor que indica se os objetos retornados do WMI devem conter informações corrigidas.Gets or sets a value indicating whether the objects returned from WMI should contain amended information. Normalmente, as informações corrigidas são informações localizáveis anexadas ao objeto WMI, tais como descrições de objeto e de propriedade.Typically, amended information is localizable information attached to the WMI object, such as object and property descriptions.

Métodos

Clone()

Retorna uma cópia do objeto.Returns a copy of the object.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Herdado de Object)
GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Herdado de Object)

Aplica-se a