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, 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 el contador de rendimiento personalizado en el equipo local o del sistema especificado. Este constructor precisa que la categoría contiene una sola instancia.

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

public PerformanceCounter(
	string categoryName,
	string counterName,
	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.

readOnly
Type: System.Boolean

true Para obtener acceso al contador en modo de sólo lectura (aunque el propio contador pueda ser de lectura y escritura); false para tener acceso al contador en modo de lectura y escritura.

Exception Condition
InvalidOperationException

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

O bien

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

O bien

La categoría especificada no existe. (if readOnly is 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-

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 tener acceso de sólo lectura o lectura/escritura 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 del constructor establece la CategoryName, CounterName, y ReadOnly 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. 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.

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.

En el ejemplo de código siguiente se crea una instancia de la PerformanceCounter clase. El ejemplo pasa los nombres de categoría, nombres de contador y un valor de marca que indica que el contador no es de sólo lectura. Este ejemplo de código forma parte de un ejemplo más extenso de la PerformanceCounter clase.

avgCounter64Sample = new PerformanceCounter("AverageCounter64SampleCategory", 
    "AverageCounter64Sample", 
    false);

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: