¿Le resultó útil esta página?
Sus comentarios sobre este contenido son muy importantes. Háganos saber su opinión.
¿Tiene comentarios adicionales?
Caracteres restantes: 1500
Exportar (0) Imprimir
Expandir todo

PerformanceCounterCategory.GetCategories (Método) (String)

Recupera una lista de las categorías de contador de rendimiento registradas en el equipo especificado.

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

public static PerformanceCounterCategory[] GetCategories (
	string machineName
)
public static PerformanceCounterCategory[] GetCategories (
	String machineName
)
public static function GetCategories (
	machineName : String
) : PerformanceCounterCategory[]

Parámetros

machineName

Equipo en el que se va a buscar.

Valor devuelto

Matriz de objetos PerformanceCounterCategory que indica las categorías que están registradas en el equipo especificado.

Tipo de excepciónCondición

ArgumentException

El parámetro machineName no es válido.

Win32Exception

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

Para recuperar las categorías del equipo local, hay que utilizar otra sobrecarga o pasar "." como parámetro machineName.

En el ejemplo de código siguiente se utiliza el método GetCategories para devolver una matriz de objetos PerformanceCounterCategory del equipo local o un equipo especificado. Se convierte la matriz de PerformanceCounterCategory en una matriz de nombres de categoría, que se ordena y se muestra al usuario. La sobrecarga GetCategories se selecciona basándose en si se ha especificado un nombre de equipo.

Sub Main(ByVal args() As String)
    Dim categoryName As String
    Dim machineName As String = ""
    Dim categories() As PerformanceCounterCategory

    ' Copy the machine name argument into the local variable.
    Try
        machineName = IIf(args(0) = ".", "", args(0))
    Catch ex As Exception
    End Try

    ' Generate a list of categories registered on the specified computer.
    Try
        If machineName.Length > 0 Then
            categories = _
                PerformanceCounterCategory.GetCategories(machineName)
        Else
            categories = PerformanceCounterCategory.GetCategories()
        End If
    Catch ex As Exception
        Console.WriteLine("Unable to get categories on " & _
            IIf(machineName.Length > 0, "computer ""{0}"":", _
            "this computer:"), machineName)
        Console.WriteLine(ex.Message)
        Return
    End Try

    Console.WriteLine("These categories are registered on " & _
        IIf(machineName.Length > 0, _
            "computer ""{0}"":", "this computer:"), machineName)

    ' Create and sort an array of category names.
    Dim categoryNames(categories.Length - 1) As String
    Dim objX As Integer
    For objX = 0 To categories.Length - 1
        categoryNames(objX) = categories(objX).CategoryName
    Next
    Array.Sort(categoryNames)

    For objX = 0 To categories.Length - 1
        Console.WriteLine("{0,4} - {1}", objX + 1, _
            categoryNames(objX))
    Next objX
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

Adiciones de comunidad

AGREGAR
Mostrar:
© 2015 Microsoft