EnumerationOptions Classe

  • Referência

Definição

Namespace:
System.Management
Assembly:
System.Management.dll
Pacote:
System.Management v6.0.0
Pacote:
System.Management v7.0.0
Pacote:
System.Management v8.0.0
Pacote:
System.Management v9.0.0-preview.2.24128.5
Origem:
ManagementOptions.cs
Origem:
ManagementOptions.cs
Origem:
ManagementOptions.cs

Fornece uma classe base para consulta e objetos de opção relacionados à enumeração.

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
Object
ManagementOptions
EnumerationOptions

Exemplos

O exemplo a seguir inicializa uma EnumerationOptions variável com um EnumerationOptions construtor e obtém todas as instâncias de uma classe WMI e suas 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). Esse é o construtor sem parâmetros.
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.

Propriedades

BlockSize

Obtém ou define o tamanho do bloco para operações de bloco. Ao enumerar por meio de uma coleção, o WMI retornará resultados em grupos do tamanho especificado.
Context

Obtém ou define um objeto de contexto WMI. 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.

(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.
EnsureLocatable

Obtém ou define um valor que indica se os objetos retornados devem conter informações localizáveis. Isso garante que as propriedades do sistema, como __PATH, __RELPATH e __SERVER não sejam NULL. Esse sinalizador só pode ser usado em consultas e é ignorado em enumerações.
EnumerateDeep

Obtém ou define um valor que indica se a enumeração recursiva é solicitada em todas as classes derivadas da superclasse especificada. Se false, somente os membros imediatos da classe derivada são retornados.
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. Este sinalizador é usado para criação de protótipos.
ReturnImmediately

Obtém ou define um valor que indica se a operação invocada deve ser executada de forma síncrona ou semissíncrona. Se essa propriedade for definida como true, a enumeração será invocada e a chamada será retornada imediatamente. A recuperação real dos resultados ocorrerá quando a coleção resultante for percorrida.
Rewindable

Obtém ou define um valor que indica se a coleção pode ser retrocedida. Se true, os objetos na coleção serão mantidos disponíveis para várias enumerações. Se false, a coleção só poderá ser enumerada uma vez.
Timeout

Obtém ou define o tempo limite para aplicar a operação. 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). Essa propriedade é usada para indicar que a operação deve ser realizada de forma semissíncrona.

(Herdado de ManagementOptions)
UseAmendedQualifiers

Obtém ou define um valor que indica se os objetos retornados do WMI devem conter informações corrigidas. Normalmente, as informações corrigidas são informações localizáveis anexadas ao objeto WMI, tais como descrições de objeto e de propriedade.

Métodos

Clone()

Retorna uma cópia do objeto.
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como a função de hash padrão.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do Object atual.

(Herdado de Object)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)

Aplica-se a