PerformanceCounter Constructor (String, String)
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

PerformanceCounter (Constructor) (String, String)

 

Inicializa una nueva instancia de sólo lectura de la clase PerformanceCounter y la asocia al contador de rendimiento personalizado o del sistema especificado en el equipo local.Este constructor precisa que la categoría tenga una sola instancia.

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

public PerformanceCounter(
	string categoryName,
	string counterName
)

Parámetros

categoryName

Nombre de la categoría de contador de rendimiento (objeto de rendimiento) a la que está asociado este contador de rendimiento.

counterName

Nombre del contador de rendimiento.

Exception Condition
InvalidOperationException

categoryName es una cadena vacía ("").

O bien

counterName es una cadena vacía ("").

O bien

La categoría especificada no existe.

-o-

La categoría especificada se marca como de varias instancias y exige que se cree un contador de rendimiento con el nombre de una instancia.

-o-

categoryName y counterName se han localizado en distintos idiomas.

ArgumentNullException

categoryName o counterName es null.

Win32Exception

Se ha producido un error en el acceso a una API del sistema.

PlatformNotSupportedException

La plataforma es Windows 98 o Windows Millennium Edition (Me), que no admiten contadores de rendimiento.

UnauthorizedAccessException

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

Las cadenas de parámetros no distinguen mayúsculas de minúsculas.

Utilice esta sobrecarga para obtener acceso a un contador del equipo local que pertenezca a una categoría que contenga una sola instancia de categoría de contador de rendimiento.Si intenta utilizar este constructor para que la instancia de PerformanceCounter apunte a una categoría que contiene varias instancias, el constructor produce una excepción.Esta sobrecarga puede obtener acceso a cualquier contador de sólo lectura o de lectura y escritura, pero lo hace en modo de sólo lectura.Una instancia de PerformanceCounter creada mediante esta sobrecarga no puede escribir en el contador, aunque el propio contador sea de lectura y escritura.

Esta sobrecarga del constructor establece las propiedades CategoryName y CounterName en los valores que se pasen, establece la propiedad MachineName en el equipo local (".") y establece la propiedad InstanceName en una cadena vacía ("").

Este constructor inicializa el contador de rendimiento y asocia la instancia a un contador existente (ya sea personalizado o del sistema) en el equipo local.Los valores que se pasen para las propiedades CategoryName y CounterName deben apuntar a un contador de rendimiento existente en el equipo local.

System_CAPS_noteNota

Para leer los contadores de rendimiento de Windows Vista, 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, agregue su propio usuario al grupo Usuarios del monitor de sistema.

En Windows Vista, 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.

PerformanceCounterPermission

para leer la categoría de contador de rendimiento si la propiedad ReadOnly es true.Enumeración asociada: PerformanceCounterPermissionAccess.Read.

PerformanceCounterPermission

para escribir la categoría de contador de rendimiento si la propiedad ReadOnly es false.Enumeración asociada: PerformanceCounterPermissionAccess.Write.

.NET Framework
Disponible desde 1.1
Volver al principio
Mostrar:
© 2016 Microsoft