Esta documentación está archivada y no tiene mantenimiento.

PerformanceCounterCategory.GetCounters (Método) ()

Recupera una lista de los contadores de una categoría de contador de rendimiento que contiene exactamente una instancia.

Espacio de nombres: System.Diagnostics
Ensamblado: System (en system.dll)

public PerformanceCounter[] GetCounters ()
public PerformanceCounter[] GetCounters ()
public function GetCounters () : PerformanceCounter[]

Valor devuelto

Matriz de objetos PerformanceCounter que indica los contadores que están asociados a esta categoría de contador de rendimiento de una sola instancia.

Tipo de excepciónCondición

ArgumentException

La categoría no es una instancia única.

Win32Exception

Se ha producido un error en la llamada a una API del sistema subyacente.

InvalidOperationException

La categoría no tiene una instancia asociada.

Para obtener más información sobre las instancias de objetos de rendimiento, vea la información general de la clase PerformanceCounter.

En el ejemplo de código siguiente se obtiene una lista de los objetos PerformanceCounter de una PerformanceCounterCategory. Primero, se crea una PerformanceCounterCategory con el constructor adecuado, basándose en si se ha especificado un nombre de equipo. A continuación, se utiliza el método GetCounters para devolver una matriz de objetos PerformanceCounter, seleccionando la sobrecarga GetCounters según se haya especificado un nombre de instancia.

Esta sobrecarga GetCounters genera un error, a menos que se utilice con una categoría de una sola instancia.

Sub Main(ByVal args() As String)
    Dim categoryName As String = ""
    Dim machineName As String = ""
    Dim instanceName As String = ""
    Dim pcc As PerformanceCounterCategory
    Dim counters() As PerformanceCounter

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

    Try
        ' Create the appropriate PerformanceCounterCategory object.
        If machineName.Length > 0 Then
            pcc = New PerformanceCounterCategory(categoryName, machineName)
        Else
            pcc = New PerformanceCounterCategory(categoryName)
        End If

        ' Get the counters for this instance or a single instance 
        ' of the selected category.
        If instanceName.Length > 0 Then
            counters = pcc.GetCounters(instanceName)
        Else
            counters = pcc.GetCounters()
        End If

    Catch ex As Exception
        Console.WriteLine("Unable to get counter information for " & _
            IIf(instanceName.Length > 0, "instance ""{2}"" in ", _
            "single-instance ") & "category ""{0}"" on " & _
            IIf(machineName.Length > 0, "computer ""{1}"":", _
            "this computer:"), _
            categoryName, machineName, instanceName)
        Console.WriteLine(ex.Message)
        Return
    End Try

    ' Display the counter names if GetCounters was successful.
    If Not counters Is Nothing Then
        Console.WriteLine("These counters exist in " & _
            IIf(instanceName.Length > 0, "instance ""{1}"" of", _
            "single instance") & " category {0} on " & _
            IIf(machineName.Length > 0, _
                "computer ""{2}"":", "this computer:"), _
            categoryName, instanceName, machineName)

        ' Display a numbered list of the counter names.
        Dim objX As Integer
        For objX = 0 To counters.Length - 1
            Console.WriteLine("{0,4} - {1}", objX + 1, _
                counters(objX).CounterName)
        Next objX
    End If
End Sub

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter Edition

.NET Framework no admite todas las versiones de cada plataforma. Para obtener una lista de las versiones admitidas, vea Requisitos del sistema.

.NET Framework

Compatible con: 2.0, 1.1, 1.0
Mostrar: