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, 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 especificado o del sistema especificado.

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

public PerformanceCounter(
	string categoryName,
	string counterName,
	string instanceName,
	string machineName
)

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.

machineName
Type: System.String

El equipo en el que existen el contador de rendimiento y su categoría asociada.

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

El contador no existe en el equipo especificado.

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

ArgumentException

El parámetro machineName no es válido.

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, InstanceName, y MachineName Propiedades en los valores que se pasen.

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 especificado. Los valores que se pasen para el CategoryName, CounterName, InstanceName y MachineName propiedades deben apuntar a un contador de rendimiento existente. 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.

System_CAPS_noteNota

No se puede escribir en contadores de rendimiento remotos. No hay ninguna sobrecarga que le permite especificar una instancia de lectura y escritura de la PerformanceCounter clase que se conecta a un equipo remoto.

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.

System_CAPS_noteNota

En Windows Vista, cuando el equipo remoto es miembro de un grupo de trabajo, debe deshabilitar UAC para que la cuenta de usuario local no se filtra y pueda elevarse a una cuenta de administrador. Por motivos de seguridad, debe deshabilitar UAC un último recurso. Para obtener información acerca de cómo deshabilitar UAC, consulte User Account Control and WMI.

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: