PerformanceCounter.CounterHelp Propiedad

Definición

Espacio de nombres:

System.Diagnostics

Ensamblado:

System.Diagnostics.PerformanceCounter.dll

Paquete:

System.Diagnostics.PerformanceCounter v8.0.0

Source:

PerformanceCounter.cs

Obtiene la descripción de este contador de rendimiento.

public:
 property System::String ^ CounterHelp { System::String ^ get(); };

public string CounterHelp { get; }

member this.CounterHelp : string

Public ReadOnly Property CounterHelp As String

Valor de propiedad

String

Descripción del elemento o de la cantidad que este contador de rendimiento mide.

Excepciones

InvalidOperationException

La instancia de PerformanceCounter no está asociada a un contador de rendimiento.

o bien

La propiedad InstanceLifetime se ha establecido en Process pero se está usando la memoria compartida global.

UnauthorizedAccessException

Código que se ejecuta sin privilegios administrativos para intentar leer un contador de rendimiento.

Comentarios

El cuadro de diálogo Agregar contadores del complemento MMC del Administrador de contadores de rendimiento muestra el CounterHelp texto cuando un usuario selecciona un contador de la lista contadores y hace clic en el botón Explicar.

Al crear un contador, use el CounterHelp texto para describir lo que hacen los monitores de contador para que el usuario pueda determinar si desea agregar el contador a la pantalla del Monitor de sistema.

Nota

Si el valor de la InstanceLifetime propiedad es Process y la categoría de contador de rendimiento se creó con .NET Framework versión 1.0 o 1.1, se produce una InvalidOperationException excepción . Las categorías de contadores de rendimiento creadas con versiones anteriores usan memoria compartida global y el valor de InstanceLifetime debe ser Global. Si las aplicaciones que se ejecutan en las versiones 1.0 o 1.1 de .NET Framework no usan la categoría, elimine y vuelva a crearla.

Nota

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

Para evitar tener que elevar los privilegios para acceder a los contadores de rendimiento en Windows Vista, agréguese al grupo Monitor de rendimiento Usuarios.

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 accede a los contadores de rendimiento, primero debe elevar sus privilegios del usuario estándar al 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.