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

 

Publicado: octubre de 2016

Inicializa una nueva de sólo lectura o lectura y escritura instancia 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,
	bool readOnly
)

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.

readOnly
Type: System::Boolean

true Para obtener acceso a un contador en modo de solo lectura; false para tener acceso a un contador en modo de lectura y escritura.

Exception Condition
InvalidOperationException

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

O bien

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

O bien

El permiso de lectura y escritura que se ha solicitado un valor no es válido para este contador.

O bien

La categoría especificada no existe (si readOnly es true).

O bien

La categoría especificada no es una categoría personalizada de .NET Framework (si readOnly es false).

-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.

Utilice esta sobrecarga para obtener acceso a un contador de rendimiento en modo de sólo lectura o en modo de lectura y escritura.

Esta sobrecarga del constructor establece la CategoryName, CounterName, y InstanceName Propiedades en los valores pasa y se establecen las 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 la instancia de contador de rendimiento que se apunta no es válida, la llamada al constructor produce una excepción.

System_CAPS_noteNota

Puede utilizar esta sobrecarga para conectarse a un contador del sistema, pero no se puede escribir en un contador del sistema. Por consiguiente, establecer readOnly a false al conectarse a un contador del sistema, el constructor produce una excepción.

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: