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^, String^)

 

Publicado: octubre de 2016

Inicializa una nueva instancia de sólo lectura de la PerformanceCounter de clase y lo asocia con la instancia de categoría y de contador de rendimiento personalizado en el equipo local o del sistema especificado.

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

public:
PerformanceCounter(
	String^ categoryName,
	String^ counterName,
	String^ instanceName
)

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.

instanceName
Type: System::String^

El nombre de la instancia de categoría del contador de rendimiento o una cadena vacía (""), si la categoría contiene una sola instancia.

Exception Condition
InvalidOperationException

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

O bien

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

O bien

La categoría especificada no es válida.

-o-

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-

instanceName tiene más de 127 caracteres.

-o-

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.

Esta sobrecarga del constructor establece la CategoryName, CounterName, y InstanceName Propiedades en los valores pasar y establece el MachineName propiedad en el equipo local, ".".

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, CounterName, y InstanceName propiedades deben apuntar a un contador de rendimiento existente en el equipo local. Si señala a la instancia de contador de rendimiento no es válida, al llamar al constructor, produce 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.

Para crear una instancia de categoría de rendimiento, especifique una instanceName en el PerformanceCounter constructor. Si la instancia de categoría especificada por instanceName ya existe el nuevo objeto hará referencia a la instancia de categoría existente.

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: