Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

PerformanceCounterCategory.GetCounters (Método) (String)

 

Recupera una lista de los contadores de una categoría de contador de rendimiento que contiene una o más instancias.

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

member GetCounters : 
        instanceName:string -> PerformanceCounter[]

Parámetros

instanceName

Instancia de objeto de rendimiento para la que se va a recuperar una lista de contadores asociados.

Valor devuelto

Type: System.Diagnostics.PerformanceCounter[]

Matriz de objetos PerformanceCounter que indica los contadores asociados a la instancia de objeto especificada de esta categoría de contador de rendimiento.

Exception Condition
ArgumentNullException

El valor del parámetro instanceName es null.

InvalidOperationException

No se ha establecido la propiedad CategoryName para esta instancia de PerformanceCounterCategory.

O bien

La categoría no contiene la instancia especificada en el parámetro instanceName.

Win32Exception

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

UnauthorizedAccessException

Código que se ejecuta sin privilegios administrativos para intentar leer un contador de rendimiento.

Para representar una categoría de una sola instancia, hay que pasar una cadena vacía ("") como valor del parámetro instanceName.

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

System_CAPS_noteNota

Para leer los contadores de rendimiento de Windows Vista y versiones posteriores, Windows XP Professional x64 Edition o Windows Server 2003, debe ser miembro del grupo Usuarios del monitor de sistema o tener privilegios administrativos.

Para evitar la elevación de los privilegios de acceso a los contadores de rendimiento en Windows Vista y versiones posteriores, agregue su propio usuario al grupo Usuarios del monitor de sistema.

En Windows Vista y posteriores, el Control de cuentas de usuario (UAC) determina los privilegios de un usuario.Si es miembro del grupo Administradores integrados, se le asignarán dos símbolos (tokens) de acceso en tiempo de ejecución: un símbolo (token) de acceso de usuario estándar y un símbolo (token) de acceso de administrador.De forma predeterminada, se le asignará el rol de usuario estándar.Para ejecutar el código que tiene acceso a los contadores de rendimiento, primero debe elevar el nivel de sus privilegios de usuario estándar a administrador.Podrá hacerlo cuando inicie una aplicación haciendo clic con el botón secundario en el icono de la aplicación e indicando que desea ejecutarla como administrador.

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(String) genera un error, a menos que se utilice con una categoría que contiene varias instancias.

No hay ningún ejemplo de código disponible o este idioma no es compatible.

.NET Framework
Disponible desde 1.1
Volver al principio
Mostrar: