PerformanceCounter.CounterType (Propiedad)
Actualización: noviembre 2007
Obtiene el tipo de contador del contador de rendimiento asociado.
Ensamblado: System (en System.dll)
/** @property */ public PerformanceCounterType get_CounterType()
public function get CounterType () : PerformanceCounterType
Valor de propiedad
Tipo: System.Diagnostics.PerformanceCounterTypePerformanceCounterType que describe la forma en que el contador interactúa con una aplicación de supervisión y la naturaleza de los valores que contiene (por ejemplo, calculados o no calculados).
| Excepción | Condición |
|---|---|
| InvalidOperationException | La instancia no está correctamente asociada a un contador de rendimiento. O bien, La propiedad InstanceLifetime se ha establecido en Process pero se está utilizando la memoria compartida global. |
| PlatformNotSupportedException | La plataforma es Windows 98 o Windows Millennium Edition (Me), que no admiten contadores de rendimiento. |
| UnauthorizedAccessException | Código que se ejecuta sin privilegios administrativos para intentar leer un contador de rendimiento. |
La enumeración PerformanceCounterType contiene los tipos de contadores de rendimiento con los que se puede interactuar. Algunos tipos de contador representan valores calculados, como el promedio de las medidas de contador calculadas por el sistema. Otros tipos representan valores sin formato o no calculados. En la siguiente tabla se muestran los tipos de contador con los que más interactuará.
Función del contador | Valor PerformanceCounterType | Ejemplo |
|---|---|---|
Mantener un recuento simple de los elementos o de las operaciones. | NumberOfItems32 | Hacer un seguimiento del número de órdenes recibidas en forma de entero de 32 bits. |
Mantener un recuento simple de mayor capacidad. | NumberOfItems64 | Hacer un seguimiento del número de órdenes de un sitio de gran volumen, que se almacena en forma de entero de 64 bits. |
Hacer un seguimiento del número de elementos o del número de operaciones por segundo. | RateOfCountsPerSecond32 | Hacer un seguimiento de las órdenes recibidas por segundo en un sitio. |
Hacer un seguimiento de un número de mayor capacidad de elementos o de operaciones por segundo. | RateOfCountsPerSecond64 | Hacer un seguimiento de las órdenes recibidas por segundo en un sitio de gran volumen. |
Calcular el tiempo promedio que se tarda en realizar un proceso o en procesar un elemento. | AverageTimer32 | Calcular el tiempo promedio que se tarda en procesar una orden. |
Cuando cree un contador cuyo tipo requiera el uso de un contador base correspondiente, deberá declarar el contador y la base en el objeto CounterCreationDataCollection que se pase en el método PerformanceCounterCategory.Create.
Nota: |
|---|
Si el valor para la propiedad InstanceLifetime es Process y la categoría de contador de rendimiento se ha creado con la versión 1.0 o 1.1 de .NET Framework, se produce una excepción InvalidOperationException. Las categorías de contador de rendimiento que se crean con las versiones anteriores utilizan la memoria compartida global y el valor de InstanceLifetime debe ser Global. Si las aplicaciones que se ejecutan con las versiones 1.0 o 1.1 de .NET Framework no utilizan la categoría, elimínela y vuelva a crearla. |
Nota: |
|---|
Para leer los contadores de rendimiento de 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 la elevación de los privilegios de acceso a los contadores de rendimiento en Windows Vista, agregue su propio usuario al grupo Usuarios del monitor de sistema. 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á la función de usuario estándar. Para ejecutar el código que tiene acceso a los contadores de rendimiento, primero debe elevar el nivel de sus privilegios de usuario estándar a administrador. Puede hacerlo si inicia una aplicación haciendo clic con el botón secundario en el icono de la aplicación e indicando que desea ejecutarla como administrador. |
- PerformanceCounterPermission
para leer la categoría de contador de rendimiento. Enumeración asociada: PerformanceCounterPermissionAccess.Read.
Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98
.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.
Nota: