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

Constructor PerformanceCounter (String, String)

 

Publicado: octubre de 2016

Inicializa una nueva instancia de sólo lectura de la PerformanceCounter de clase y lo asocia con el contador de rendimiento personalizado en el equipo local o del sistema especificado. 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
Type: System.String

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

counterName
Type: System.String

El 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 bien

La categoría especificada se marca como de varias instancias y requiere que el contador de rendimiento que se creó con un nombre de instancia.

O bien

categoryName y counterName se han localizado en distintos idiomas.

ArgumentNullException

El valor de categoryName o counterName es null.

Win32Exception

Error de acceso a la API del sistema.

PlatformNotSupportedException

La plataforma es Windows 98 o Windows Millennium Edition, que no admite los contadores de rendimiento.

UnauthorizedAccessException

Código que se ejecuta sin privilegios administrativos intentó 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 en el equipo local que pertenezca a una categoría que contenga una instancia de categoría de contador de rendimiento único. Si intenta utilizar este constructor para señalar esto PerformanceCounter instancia a una categoría que contiene varias instancias, el constructor inicia una excepción. Esta sobrecarga puede obtener acceso a cualquier de sólo lectura o lectura/escritura contador, pero lo hace en modo de sólo lectura. Un PerformanceCounter instancia creada mediante esta sobrecarga no puede escribir en el contador, aunque el propio contador sea de lectura y escritura.

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

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

System_CAPS_noteNota

Para leer los contadores de rendimiento en Windows Vista, Windows XP Professional x64 Edition o Windows Server 2003, debe ser miembro del grupo usuarios del Monitor de rendimiento o tener privilegios administrativos.

Para evitar tener que elevar sus privilegios para tener acceso a los contadores de rendimiento en Windows Vista, agréguese al grupo usuarios del Monitor de rendimiento.

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 sus privilegios de usuario estándar a administrador. Para ello, inicie una aplicación haciendo clic con el botón derecho en el icono de la aplicación e indique que desea ejecutarla como administrador.

PerformanceCounterPermission

for reading the performance counter category if the P:System.Diagnostics.PerformanceCounter.ReadOnly property is true. Associated enumeration: F:System.Diagnostics.PerformanceCounterPermissionAccess.Read.

PerformanceCounterPermission

for writing the performance counter category if the P:System.Diagnostics.PerformanceCounter.ReadOnly property is false. Associated enumeration: F:System.Diagnostics.PerformanceCounterPermissionAccess.Write.

.NET Framework
Disponible desde 1.1
Volver al principio
Mostrar: