PerformanceCounterCategory.CounterExists Метод

Определение

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

Сборка:: System.Diagnostics.PerformanceCounter.dll

Сборка:: System.dll

Пакет:: System.Diagnostics.PerformanceCounter v11.0.0-preview.4.26230.115

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Определяет, зарегистрирован ли указанный счетчик в определенной категории.

Перегрузки

Имя	Описание
CounterExists(String)	Определяет, зарегистрирован ли указанный счетчик в этой категории, который указывается свойствами и CategoryName свойствамиMachineName.
CounterExists(String, String)	Определяет, зарегистрирован ли указанный счетчик в указанной категории на локальном компьютере.
CounterExists(String, String, String)	Определяет, зарегистрирован ли указанный счетчик в указанной категории на удаленном компьютере.

CounterExists(String)

Исходный код:: PerformanceCounterCategory.cs

Исходный код:: PerformanceCounterCategory.cs

Исходный код:: PerformanceCounterCategory.cs

Исходный код:: PerformanceCounterCategory.cs

Исходный код:: PerformanceCounterCategory.cs

Исходный код:: PerformanceCounterCategory.cs

Исходный код:: PerformanceCounterCategory.cs

Исходный код:: PerformanceCounterCategory.cs

Определяет, зарегистрирован ли указанный счетчик в этой категории, который указывается свойствами и CategoryName свойствамиMachineName.

public:
 bool CounterExists(System::String ^ counterName);

public bool CounterExists(string counterName);

member this.CounterExists : string -> bool

Public Function CounterExists (counterName As String) As Boolean

Параметры

counterName: String

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

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

Boolean

trueЗначение , если счетчик зарегистрирован в категории, указанной и свойствамиCategoryName; в противном случае MachineName.false

Исключения

ArgumentNullException

Значение counterName равно null.

InvalidOperationException

Свойство CategoryName не задано.

Win32Exception

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

UnauthorizedAccessException

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

Примеры

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

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

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

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

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

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

Sub Main(ByVal args() As String)
    Dim categoryName As String = ""
    Dim counterName As String = ""
    Dim machineName As String = ""
    Dim objectExists As Boolean = False
    Dim pcc As PerformanceCounterCategory

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

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

        ' Check whether the specified counter exists.
        ' Use the per-instance overload of CounterExists.
        objectExists = pcc.CounterExists(counterName)

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

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

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

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

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

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

Применяется к

CounterExists(String, String)

Исходный код:: PerformanceCounterCategory.cs

Исходный код:: PerformanceCounterCategory.cs

Исходный код:: PerformanceCounterCategory.cs

Исходный код:: PerformanceCounterCategory.cs

Исходный код:: PerformanceCounterCategory.cs

Исходный код:: PerformanceCounterCategory.cs

Исходный код:: PerformanceCounterCategory.cs

Исходный код:: PerformanceCounterCategory.cs

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

public:
 static bool CounterExists(System::String ^ counterName, System::String ^ categoryName);

public static bool CounterExists(string counterName, string categoryName);

static member CounterExists : string * string -> bool

Public Shared Function CounterExists (counterName As String, categoryName As String) As Boolean

Параметры

counterName: String

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

categoryName: String

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

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

Boolean

true, если счетчик зарегистрирован в указанной категории на локальном компьютере; falseв противном случае .

Исключения

ArgumentNullException

Значение categoryName равно null.

–или–

Значение counterName равно null.

ArgumentException

Это categoryName пустая строка ("").

InvalidOperationException

Имя категории не существует.

Win32Exception

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

UnauthorizedAccessException

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

Примеры

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

public static void Main(string[] args)
{
    string categoryName = "";
    string counterName = "";
    string machineName = "";
    bool objectExists = false;

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

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

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

Sub Main(ByVal args() As String)
    Dim categoryName As String = ""
    Dim counterName As String = ""
    Dim machineName As String = ""
    Dim objectExists As Boolean = False

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

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

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

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

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

Применяется к

CounterExists(String, String, String)

Исходный код:: PerformanceCounterCategory.cs

Исходный код:: PerformanceCounterCategory.cs

Исходный код:: PerformanceCounterCategory.cs

Исходный код:: PerformanceCounterCategory.cs

Исходный код:: PerformanceCounterCategory.cs

Исходный код:: PerformanceCounterCategory.cs

Исходный код:: PerformanceCounterCategory.cs

Исходный код:: PerformanceCounterCategory.cs

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

public:
 static bool CounterExists(System::String ^ counterName, System::String ^ categoryName, System::String ^ machineName);

public static bool CounterExists(string counterName, string categoryName, string machineName);

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

Public Shared Function CounterExists (counterName As String, categoryName As String, machineName As String) As Boolean

Параметры

counterName: String

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

categoryName: String

machineName: String

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

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

Boolean

true, если счетчик зарегистрирован в указанной категории на указанном компьютере; falseв противном случае .

Исключения

ArgumentNullException

Значение categoryName равно null.

–или–

Значение counterName равно null.

ArgumentException

Это categoryName пустая строка ("").

–или–

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

InvalidOperationException

Имя категории не существует.

Win32Exception

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

UnauthorizedAccessException

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

Примеры

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

public static void Main(string[] args)
{
    string categoryName = "";
    string counterName = "";
    string machineName = "";
    bool objectExists = false;

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

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

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

Sub Main(ByVal args() As String)
    Dim categoryName As String = ""
    Dim counterName As String = ""
    Dim machineName As String = ""
    Dim objectExists As Boolean = False

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

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

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

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

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

Применяется к

Обратная связь

Были ли сведения на этой странице полезными?

PerformanceCounterCategory.CounterExists Метод

Определение

Перегрузки

CounterExists(String)

Параметры

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

Исключения

Примеры

Комментарии

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

Применяется к

CounterExists(String, String)

Параметры

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

Исключения

Примеры

Комментарии

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

Применяется к

CounterExists(String, String, String)

Параметры

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

Исключения

Примеры

Комментарии

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

Применяется к