PerformanceCounterCategory.InstanceExists Метод

Определение

Пространство имен:

System.Diagnostics

Сборка:

System.Diagnostics.PerformanceCounter.dll

Пакет:

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

Определяет, содержит ли категория указанный экземпляр объекта производительности.

Перегрузки

InstanceExists(String)	Определяет, существует ли указанный экземпляр объекта производительности в категории, определяемой этим свойством CategoryName объекта PerformanceCounterCategory.
InstanceExists(String, String)	Определяет, содержит ли указанная категория на локальном компьютере указанный экземпляр объекта производительности.
InstanceExists(String, String, String)	Определяет, содержит ли указанная категория на указанном компьютере указанный экземпляр объекта производительности.

InstanceExists(String)

Исходный код:

PerformanceCounterCategory.cs

Определяет, существует ли указанный экземпляр объекта производительности в категории, определяемой этим свойством CategoryName объекта 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

Параметры

instanceName

String

Экземпляр объекта производительности в этой категории счетчика производительности для поиска.

Возвращаемое значение

Boolean

true, если категория содержит указанный экземпляр объекта производительности; в противном случае false.

Исключения

InvalidOperationException

Свойство CategoryNamenull. Возможно, свойство не задано.

ArgumentNullException

Параметр instanceNamenull.

Win32Exception

Сбой вызова базового системного API.

UnauthorizedAccessException

Код, выполняющийся без прав администратора, пытался прочитать счетчик производительности.

Примеры

В следующем примере кода определяется, существует ли экземпляр PerformanceCounter в PerformanceCounterCategory. Сначала он создает объект PerformanceCounterCategory, используя соответствующий конструктор на основе того, было ли указано имя компьютера. Затем он использует InstanceExists(String) для определения наличия указанного экземпляра, а затем сообщает пользователю. Если имя экземпляра не указано, в примере используется имя одного экземпляра по умолчанию.

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

Комментарии

Эта перегрузка InstanceExists не static. Для этого необходимо создать объект PerformanceCounterCategory и задать свойство CategoryName.

Заметка

Чтобы считывать счетчики производительности из сеанса входа в Windows Vista и более поздних версий, Windows XP Professional x64 Edition или Windows Server 2003, необходимо быть членом группы пользователей монитора производительности или иметь права администратора.

Чтобы избежать повышения привилегий для доступа к счетчикам производительности в Windows Vista и более поздних версий, добавьте себя в группу пользователей монитора производительности.

В Windows Vista и более поздних версиях контроль учетных записей (UAC) определяет привилегии пользователя. Если вы являетесь членом встроенной группы "Администраторы", вы назначаете два маркера доступа во время выполнения: маркер доступа стандартного пользователя и маркер доступа администратора. По умолчанию вы находитесь в стандартной роли пользователя. Чтобы выполнить код, который обращается к счетчикам производительности, необходимо сначала повысить привилегии от стандартного пользователя к администратору. Это можно сделать при запуске приложения, щелкнув правой кнопкой мыши значок приложения и указав, что вы хотите запустить от имени администратора.

См. также раздел

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

InstanceExists(String, String)

Исходный код:

PerformanceCounterCategory.cs

Определяет, содержит ли указанная категория на локальном компьютере указанный экземпляр объекта производительности.

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

Параметры

instanceName

String

Экземпляр объекта производительности для поиска.

categoryName

String

Категория счетчика производительности для поиска.

Возвращаемое значение

Boolean

true, если категория содержит указанный экземпляр объекта производительности; в противном случае false.

Исключения

ArgumentNullException

Параметр instanceNamenull.

-или-

Параметр categoryNamenull.

ArgumentException

Параметр categoryName является пустой строкой ("").

Win32Exception

Сбой вызова базового системного API.

UnauthorizedAccessException

Код, выполняющийся без прав администратора, пытался прочитать счетчик производительности.

Примеры

В следующем примере кода используются статические перегрузки InstanceExists для определения того, существует ли данный экземпляр PerformanceCounter в PerformanceCounterCategory. Перегрузка выбирается в зависимости от того, указано ли имя компьютера. Если имя экземпляра не указано, в примере используется имя одного экземпляра по умолчанию.

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

Комментарии

Невозможно определить, существует ли экземпляр объекта производительности на компьютере, не указывая определенную категорию для просмотра.

Заметка

Чтобы считывать счетчики производительности из сеанса входа в Windows Vista и более поздних версий, Windows XP Professional x64 Edition или Windows Server 2003, необходимо быть членом группы пользователей монитора производительности или иметь права администратора.

Чтобы избежать повышения привилегий для доступа к счетчикам производительности в Windows Vista и более поздних версий, добавьте себя в группу пользователей монитора производительности.

В Windows Vista и более поздних версиях контроль учетных записей (UAC) определяет привилегии пользователя. Если вы являетесь членом встроенной группы "Администраторы", вы назначаете два маркера доступа во время выполнения: маркер доступа стандартного пользователя и маркер доступа администратора. По умолчанию вы находитесь в стандартной роли пользователя. Чтобы выполнить код, который обращается к счетчикам производительности, необходимо сначала повысить привилегии от стандартного пользователя к администратору. Это можно сделать при запуске приложения, щелкнув правой кнопкой мыши значок приложения и указав, что вы хотите запустить от имени администратора.

См. также раздел

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

InstanceExists(String, String, String)

Исходный код:

PerformanceCounterCategory.cs

Определяет, содержит ли указанная категория на указанном компьютере указанный экземпляр объекта производительности.

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

Параметры

instanceName

String

Экземпляр объекта производительности для поиска.

categoryName

String

Категория счетчика производительности для поиска.

machineName

String

Имя компьютера, на котором выполняется поиск пары экземпляров категории.

Возвращаемое значение

Boolean

true, если категория содержит указанный экземпляр объекта производительности; в противном случае false.

Исключения

ArgumentNullException

Параметр instanceNamenull.

-или-

Параметр categoryNamenull.

ArgumentException

Параметр categoryName является пустой строкой ("").

-или-

Недопустимый параметр machineName.

Win32Exception

Сбой вызова базового системного API.

UnauthorizedAccessException

Код, выполняющийся без прав администратора, пытался прочитать счетчик производительности.

Примеры

В следующем примере кода используются статические перегрузки InstanceExists для определения того, существует ли данный экземпляр PerformanceCounter в PerformanceCounterCategory. Перегрузка выбирается в зависимости от того, указано ли имя компьютера. Если имя экземпляра не указано, в примере используется имя одного экземпляра по умолчанию.

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

Комментарии

Невозможно определить, существует ли экземпляр объекта производительности на компьютере, не указывая определенную категорию для просмотра.

Можно использовать "." для указания локального компьютера.

Заметка

Чтобы считывать счетчики производительности из сеанса входа в Windows Vista и более поздних версий, Windows XP Professional x64 Edition или Windows Server 2003, необходимо быть членом группы пользователей монитора производительности или иметь права администратора.

Чтобы избежать повышения привилегий для доступа к счетчикам производительности в Windows Vista и более поздних версий, добавьте себя в группу пользователей монитора производительности.

В Windows Vista и более поздних версиях контроль учетных записей (UAC) определяет привилегии пользователя. Если вы являетесь членом встроенной группы "Администраторы", вы назначаете два маркера доступа во время выполнения: маркер доступа стандартного пользователя и маркер доступа администратора. По умолчанию вы находитесь в стандартной роли пользователя. Чтобы выполнить код, который обращается к счетчикам производительности, необходимо сначала повысить привилегии от стандартного пользователя к администратору. Это можно сделать при запуске приложения, щелкнув правой кнопкой мыши значок приложения и указав, что вы хотите запустить от имени администратора.

См. также раздел

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