PerformanceCounterCategory.InstanceExists Método

Definição

Namespace:

System.Diagnostics

Assembly:

System.Diagnostics.PerformanceCounter.dll

Pacote:

System.Diagnostics.PerformanceCounter v9.0.0-rc.2.24473.5

Determina se a categoria contém a instância de objeto de desempenho especificada.

Sobrecargas

InstanceExists(String)	Determina se a instância de objeto de desempenho especificada existe na categoria identificada pela propriedade CategoryName desse objeto PerformanceCounterCategory.
InstanceExists(String, String)	Determina se uma categoria especificada no computador local contém a instância de objeto de desempenho especificada.
InstanceExists(String, String, String)	Determina se uma categoria especificada em um computador especificado contém a instância de objeto de desempenho especificada.

InstanceExists(String)

Origem:

PerformanceCounterCategory.cs

Determina se a instância de objeto de desempenho especificada existe na categoria identificada pela propriedade CategoryName desse objeto PerformanceCounterCategory.

public:
 bool InstanceExists(System::String ^ instanceName);

public bool InstanceExists (string instanceName);

member this.InstanceExists : string -> bool

Public Function InstanceExists (instanceName As String) As Boolean

Parâmetros

instanceName

String

A instância do objeto de desempenho nessa categoria de contador de desempenho a ser pesquisada.

Retornos

Boolean

true se a categoria contiver a instância de objeto de desempenho especificada; caso contrário, false.

Exceções

InvalidOperationException

A propriedade CategoryName é null. A propriedade pode não ter sido definida.

ArgumentNullException

O parâmetro instanceName é null.

Win32Exception

Falha em uma chamada para uma API do sistema subjacente.

UnauthorizedAccessException

Código que está sendo executado sem privilégios administrativos tentou ler um contador de desempenho.

Exemplos

O exemplo de código a seguir determina se existe uma instância de PerformanceCounter em um PerformanceCounterCategory. Ele primeiro cria um objeto PerformanceCounterCategory, usando o construtor apropriado com base em se um nome de computador foi especificado. Em seguida, ele usa InstanceExists(String) para determinar se a instância especificada existe e informa o usuário. Se nenhum nome de instância for especificado, o exemplo usará o nome de instância única padrão.

public static void Main(string[] args)
{
    string categoryName = "";
    string instanceName = "";
    string machineName = "";
    bool objectExists = false;
    PerformanceCounterCategory pcc;
    const string SINGLE_INSTANCE_NAME = "systemdiagnosticsperfcounterlibsingleinstance";

    // Copy the supplied arguments into the local variables.
    try
    {
        categoryName = args[0];
        instanceName = args[1];
        machineName = (args[2]=="."? "": args[2]);
    }
    catch(Exception ex)
    {
        // Ignore the exception from non-supplied arguments.
    }

    // Use the given instance name or use the default single-instance name.
    if (instanceName.Length==0)
    {
        instanceName = SINGLE_INSTANCE_NAME;
    }

    try
    {
        if (machineName.Length==0)
        {
            pcc = new PerformanceCounterCategory(categoryName);
        }
        else
        {
            pcc = new PerformanceCounterCategory(categoryName, machineName);
        }

        // Check whether the instance exists.
        // Use the per-instance overload of InstanceExists.
        objectExists = pcc.InstanceExists(instanceName);
    }
    catch(Exception ex)
    {
        Console.WriteLine("Unable to check for the existence of " +
            "instance \"{0}\" in category \"{1}\" on " +
            (machineName.Length>0? "computer \"{2}\":": "this computer:") +
            "\n" + ex.Message, instanceName, categoryName, machineName);
        return;
    }

    // Tell the user whether the instance exists.
    Console.WriteLine("Instance \"{0}\" " + (objectExists? "exists": "does not exist") +
        " in category \"{1}\" on " + (machineName.Length>0? "computer \"{2}\".": "this computer."),
        instanceName, pcc.CategoryName, pcc.MachineName);
}

Sub Main(ByVal args() As String)
    Dim categoryName As String = ""
    Dim instanceName As String = ""
    Dim machineName As String = ""
    Dim objectExists As Boolean = False
    Dim pcc As PerformanceCounterCategory
    Const SINGLE_INSTANCE_NAME As String = _
        "systemdiagnosticsperfcounterlibsingleinstance"

    ' Copy the supplied arguments into the local variables.
    Try
        categoryName = args(0)
        instanceName = args(1)
        machineName = IIf(args(2) = ".", "", args(2))
    Catch ex As Exception
        ' Ignore the exception from non-supplied arguments.
    End Try

    ' Use the given instance name or use the default single-instance name.
    If instanceName.Length = 0 Then
        instanceName = SINGLE_INSTANCE_NAME
    End If

    Try
        If machineName.Length = 0 Then
            pcc = New PerformanceCounterCategory(categoryName)
        Else
            pcc = New PerformanceCounterCategory(categoryName, machineName)
        End If

        ' Check whether the instance exists.
        ' Use the per-instance overload of InstanceExists.
        objectExists = pcc.InstanceExists(instanceName)

    Catch ex As Exception
        Console.WriteLine("Unable to check for the existence of " & _
            "instance ""{0}"" in category ""{1}"" on " & _
            IIf(machineName.Length > 0, _
            "computer ""{2}"":", "this computer:") & vbCrLf & _
            ex.Message, instanceName, categoryName, machineName)
        Return
    End Try

    ' Tell the user whether the instance exists.
    Console.WriteLine("Instance ""{0}"" " & _
        IIf(objectExists, "exists", "does not exist") & _
        " in category ""{1}"" on " & _
        IIf(machineName.Length > 0, _
            "computer ""{2}"".", "this computer."), _
        instanceName, pcc.CategoryName, pcc.MachineName)
End Sub

Comentários

Essa sobrecarga de InstanceExists não é static. Ele exige que você crie um objeto PerformanceCounterCategory e defina a propriedade CategoryName.

Nota

Para ler contadores de desempenho de uma sessão de logon não interativa no Windows Vista e posterior, Windows XP Professional x64 Edition ou Windows Server 2003, você deve ser membro do grupo Usuários do Monitor de Desempenho ou ter privilégios administrativos.

Para evitar ter que elevar seus privilégios para acessar contadores de desempenho no Windows Vista e posterior, adicione-se ao grupo Usuários do Monitor de Desempenho.

No Windows Vista e posterior, o UAC (Controle de Conta de Usuário) determina os privilégios de um usuário. Se você for membro do grupo Administradores Internos, será atribuído dois tokens de acesso em tempo de execução: um token de acesso de usuário padrão e um token de acesso de administrador. Por padrão, você está na função de usuário padrão. Para executar o código que acessa contadores de desempenho, primeiro você deve elevar seus privilégios de usuário padrão para administrador. Você pode fazer isso ao iniciar um aplicativo clicando com o botão direito do mouse no ícone do aplicativo e indicando que deseja executar como administrador.

Confira também

• CategoryName
• InstanceName
• CounterExists(String)
• Exists(String)
• PerformanceCounter

InstanceExists(String, String)

Origem:

PerformanceCounterCategory.cs

Determina se uma categoria especificada no computador local contém a instância de objeto de desempenho especificada.

public:
 static bool InstanceExists(System::String ^ instanceName, System::String ^ categoryName);

public static bool InstanceExists (string instanceName, string categoryName);

static member InstanceExists : string * string -> bool

Public Shared Function InstanceExists (instanceName As String, categoryName As String) As Boolean

Parâmetros

instanceName

String

A instância do objeto de desempenho a ser pesquisada.

categoryName

String

A categoria do contador de desempenho a ser pesquisada.

Retornos

Boolean

true se a categoria contiver a instância de objeto de desempenho especificada; caso contrário, false.

Exceções

ArgumentNullException

O parâmetro instanceName é null.

-ou-

O parâmetro categoryName é null.

ArgumentException

O parâmetro categoryName é uma cadeia de caracteres vazia ("").

Win32Exception

Falha em uma chamada para uma API do sistema subjacente.

UnauthorizedAccessException

Código que está sendo executado sem privilégios administrativos tentou ler um contador de desempenho.

Exemplos

O exemplo de código a seguir usa as sobrecargas estáticas de InstanceExists para determinar se a instância de PerformanceCounter fornecida existe no PerformanceCounterCategory. A sobrecarga é selecionada com base em se um nome de computador é especificado. Se nenhum nome de instância for especificado, o exemplo usará o nome de instância única padrão.

public static void Main(string[] args)
{
    string categoryName = "";
    string instanceName = "";
    string machineName = "";
    bool objectExists = false;
    const string SINGLE_INSTANCE_NAME = "systemdiagnosticsperfcounterlibsingleinstance";

    // Copy the supplied arguments into the local variables.
    try
    {
        categoryName = args[0];
        instanceName = args[1];
        machineName = args[2]=="."? "": args[2];
    }
    catch(Exception ex)
    {
        // Ignore the exception from non-supplied arguments.
    }

    // Use the given instance name or use the default single-instance name.
    if (instanceName.Length==0)
    {
        instanceName = SINGLE_INSTANCE_NAME;
    }

    try
    {
        // Check whether the specified instance exists.
        // Use the static forms of the InstanceExists method.
        if (machineName.Length==0)
        {
            objectExists = PerformanceCounterCategory.InstanceExists(instanceName, categoryName);
        }
        else
        {
            objectExists = PerformanceCounterCategory.InstanceExists(instanceName, categoryName, machineName);
        }
    }
    catch(Exception ex)
    {
        Console.WriteLine("Unable to check for the existence of " +
            "instance \"{0}\" in category \"{1}\" on " +
            (machineName.Length>0? "computer \"{2}\":": "this computer:") + "\n" +
            ex.Message, instanceName, categoryName, machineName);
        return;
    }

    // Tell the user whether the instance exists.
    Console.WriteLine("Instance \"{0}\" " + (objectExists? "exists": "does not exist") +
        " in category \"{1}\" on " + (machineName.Length>0? "computer \"{2}\".": "this computer."),
        instanceName, categoryName, machineName);
}

Sub Main(ByVal args() As String)
    Dim categoryName As String = ""
    Dim instanceName As String = ""
    Dim machineName As String = ""
    Dim objectExists As Boolean = False
    Const SINGLE_INSTANCE_NAME As String = _
        "systemdiagnosticsperfcounterlibsingleinstance"

    ' Copy the supplied arguments into the local variables.
    Try
        categoryName = args(0)
        instanceName = args(1)
        machineName = IIf(args(2) = ".", "", args(2))
    Catch ex As Exception
        ' Ignore the exception from non-supplied arguments.
    End Try

    ' Use the given instance name or use the default single-instance name.
    If instanceName.Length = 0 Then
        instanceName = SINGLE_INSTANCE_NAME
    End If

    Try
        ' Check whether the specified instance exists.
        ' Use the static forms of the InstanceExists method.
        If machineName.Length = 0 Then
            objectExists = PerformanceCounterCategory.InstanceExists( _
                instanceName, categoryName)
        Else
            objectExists = PerformanceCounterCategory.InstanceExists( _
                instanceName, categoryName, machineName)
        End If

    Catch ex As Exception
        Console.WriteLine("Unable to check for the existence of " & _
            "instance ""{0}"" in category ""{1}"" on " & _
            IIf(machineName.Length > 0, _
            "computer ""{2}"":", "this computer:") & vbCrLf & _
            ex.Message, instanceName, categoryName, machineName)
        Return
    End Try

    ' Tell the user whether the instance exists.
    Console.WriteLine("Instance ""{0}"" " & _
        IIf(objectExists, "exists", "does not exist") & _
        " in category ""{1}"" on " & _
        IIf(machineName.Length > 0, _
            "computer ""{2}"".", "this computer."), _
        instanceName, categoryName, machineName)
End Sub

Comentários

Não é possível determinar se existe uma instância de objeto de desempenho em um computador sem especificar uma categoria específica a ser pesquisada.

Nota

Para ler contadores de desempenho de uma sessão de logon não interativa no Windows Vista e posterior, Windows XP Professional x64 Edition ou Windows Server 2003, você deve ser membro do grupo Usuários do Monitor de Desempenho ou ter privilégios administrativos.

Para evitar ter que elevar seus privilégios para acessar contadores de desempenho no Windows Vista e posterior, adicione-se ao grupo Usuários do Monitor de Desempenho.

No Windows Vista e posterior, o UAC (Controle de Conta de Usuário) determina os privilégios de um usuário. Se você for membro do grupo Administradores Internos, será atribuído dois tokens de acesso em tempo de execução: um token de acesso de usuário padrão e um token de acesso de administrador. Por padrão, você está na função de usuário padrão. Para executar o código que acessa contadores de desempenho, primeiro você deve elevar seus privilégios de usuário padrão para administrador. Você pode fazer isso ao iniciar um aplicativo clicando com o botão direito do mouse no ícone do aplicativo e indicando que deseja executar como administrador.

Confira também

• InstanceName
• CounterExists(String)
• Exists(String)
• PerformanceCounter

InstanceExists(String, String, String)

Origem:

PerformanceCounterCategory.cs

Determina se uma categoria especificada em um computador especificado contém a instância de objeto de desempenho especificada.

public:
 static bool InstanceExists(System::String ^ instanceName, System::String ^ categoryName, System::String ^ machineName);

public static bool InstanceExists (string instanceName, string categoryName, string machineName);

static member InstanceExists : string * string * string -> bool

Public Shared Function InstanceExists (instanceName As String, categoryName As String, machineName As String) As Boolean

Parâmetros

instanceName

String

A instância do objeto de desempenho a ser pesquisada.

categoryName

String

A categoria do contador de desempenho a ser pesquisada.

machineName

String

O nome do computador no qual procurar o par de instâncias de categoria.

Retornos

Boolean

true se a categoria contiver a instância de objeto de desempenho especificada; caso contrário, false.

Exceções

ArgumentNullException

O parâmetro instanceName é null.

-ou-

O parâmetro categoryName é null.

ArgumentException

O parâmetro categoryName é uma cadeia de caracteres vazia ("").

-ou-

O parâmetro machineName é inválido.

Win32Exception

Falha em uma chamada para uma API do sistema subjacente.

UnauthorizedAccessException

Código que está sendo executado sem privilégios administrativos tentou ler um contador de desempenho.

Exemplos

O exemplo de código a seguir usa as sobrecargas estáticas de InstanceExists para determinar se a instância de PerformanceCounter fornecida existe no PerformanceCounterCategory. A sobrecarga é selecionada com base em se um nome de computador é especificado. Se nenhum nome de instância for especificado, o exemplo usará o nome de instância única padrão.

public static void Main(string[] args)
{
    string categoryName = "";
    string instanceName = "";
    string machineName = "";
    bool objectExists = false;
    const string SINGLE_INSTANCE_NAME = "systemdiagnosticsperfcounterlibsingleinstance";

    // Copy the supplied arguments into the local variables.
    try
    {
        categoryName = args[0];
        instanceName = args[1];
        machineName = args[2]=="."? "": args[2];
    }
    catch(Exception ex)
    {
        // Ignore the exception from non-supplied arguments.
    }

    // Use the given instance name or use the default single-instance name.
    if (instanceName.Length==0)
    {
        instanceName = SINGLE_INSTANCE_NAME;
    }

    try
    {
        // Check whether the specified instance exists.
        // Use the static forms of the InstanceExists method.
        if (machineName.Length==0)
        {
            objectExists = PerformanceCounterCategory.InstanceExists(instanceName, categoryName);
        }
        else
        {
            objectExists = PerformanceCounterCategory.InstanceExists(instanceName, categoryName, machineName);
        }
    }
    catch(Exception ex)
    {
        Console.WriteLine("Unable to check for the existence of " +
            "instance \"{0}\" in category \"{1}\" on " +
            (machineName.Length>0? "computer \"{2}\":": "this computer:") + "\n" +
            ex.Message, instanceName, categoryName, machineName);
        return;
    }

    // Tell the user whether the instance exists.
    Console.WriteLine("Instance \"{0}\" " + (objectExists? "exists": "does not exist") +
        " in category \"{1}\" on " + (machineName.Length>0? "computer \"{2}\".": "this computer."),
        instanceName, categoryName, machineName);
}

Sub Main(ByVal args() As String)
    Dim categoryName As String = ""
    Dim instanceName As String = ""
    Dim machineName As String = ""
    Dim objectExists As Boolean = False
    Const SINGLE_INSTANCE_NAME As String = _
        "systemdiagnosticsperfcounterlibsingleinstance"

    ' Copy the supplied arguments into the local variables.
    Try
        categoryName = args(0)
        instanceName = args(1)
        machineName = IIf(args(2) = ".", "", args(2))
    Catch ex As Exception
        ' Ignore the exception from non-supplied arguments.
    End Try

    ' Use the given instance name or use the default single-instance name.
    If instanceName.Length = 0 Then
        instanceName = SINGLE_INSTANCE_NAME
    End If

    Try
        ' Check whether the specified instance exists.
        ' Use the static forms of the InstanceExists method.
        If machineName.Length = 0 Then
            objectExists = PerformanceCounterCategory.InstanceExists( _
                instanceName, categoryName)
        Else
            objectExists = PerformanceCounterCategory.InstanceExists( _
                instanceName, categoryName, machineName)
        End If

    Catch ex As Exception
        Console.WriteLine("Unable to check for the existence of " & _
            "instance ""{0}"" in category ""{1}"" on " & _
            IIf(machineName.Length > 0, _
            "computer ""{2}"":", "this computer:") & vbCrLf & _
            ex.Message, instanceName, categoryName, machineName)
        Return
    End Try

    ' Tell the user whether the instance exists.
    Console.WriteLine("Instance ""{0}"" " & _
        IIf(objectExists, "exists", "does not exist") & _
        " in category ""{1}"" on " & _
        IIf(machineName.Length > 0, _
            "computer ""{2}"".", "this computer."), _
        instanceName, categoryName, machineName)
End Sub

Comentários

Não é possível determinar se existe uma instância de objeto de desempenho em um computador sem especificar uma categoria específica a ser pesquisada.

Você pode usar "." para especificar o computador local.

Nota

Para ler contadores de desempenho de uma sessão de logon não interativa no Windows Vista e posterior, Windows XP Professional x64 Edition ou Windows Server 2003, você deve ser membro do grupo Usuários do Monitor de Desempenho ou ter privilégios administrativos.

Para evitar ter que elevar seus privilégios para acessar contadores de desempenho no Windows Vista e posterior, adicione-se ao grupo Usuários do Monitor de Desempenho.

No Windows Vista e posterior, o UAC (Controle de Conta de Usuário) determina os privilégios de um usuário. Se você for membro do grupo Administradores Internos, será atribuído dois tokens de acesso em tempo de execução: um token de acesso de usuário padrão e um token de acesso de administrador. Por padrão, você está na função de usuário padrão. Para executar o código que acessa contadores de desempenho, primeiro você deve elevar seus privilégios de usuário padrão para administrador. Você pode fazer isso ao iniciar um aplicativo clicando com o botão direito do mouse no ícone do aplicativo e indicando que deseja executar como administrador.

Confira também

• InstanceName
• CounterExists(String)
• Exists(String)
• PerformanceCounter