Exportar (0) Imprimir
Expandir todo
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

PerformanceCounter (Constructor) (String, String, Boolean)

Inicializa una nueva instancia de sólo lectura o de lectura y escritura de la clase PerformanceCounter y la asocia al contador de rendimiento personalizado o del sistema especificado en el equipo local. Este constructor precisa que la categoría contenga una sola instancia.

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

new : 
        categoryName:string * 
        counterName:string * 
        readOnly:bool -> PerformanceCounter

Parámetros

categoryName
Tipo: System.String
Nombre de la categoría de contador de rendimiento (objeto de rendimiento) a la que está asociado este contador de rendimiento.
counterName
Tipo: System.String
Nombre del contador de rendimiento.
readOnly
Tipo: System.Boolean
Este atributo se establece en true para obtener acceso al contador en modo de sólo lectura (aunque el propio contador pueda ser de lectura y escritura); se establece en false para obtener acceso al contador en modo de lectura y escritura.

ExcepciónCondición
InvalidOperationException

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

O bien

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

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 bien

La categoría especificada se marca como de varias instancias y exige que se cree un contador de rendimiento con el nombre de una instancia.

O bien

categoryName y counterName se han localizado en distintos idiomas.

ArgumentNullException

categoryName o counterName es referencia null (Nothing en Visual Basic).

Win32Exception

Se ha producido un error en el acceso a una API del sistema.

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.

Las cadenas de parámetros no distinguen mayúsculas de minúsculas.

Utilice esta sobrecarga para obtener acceso a un contador de sólo lectura o de lectura y escritura en el equipo local que pertenezca a una categoría que contenga una sola instancia de categoría de contador de rendimiento. Si intenta utilizar este constructor para que la instancia de PerformanceCounter apunte a una categoría que contiene varias instancias, el constructor produce una excepción.

Esta sobrecarga del constructor establece las propiedades CategoryName, CounterName y ReadOnly en los valores que se pasen, establece la propiedad MachineName en el equipo local (".") y establece la propiedad InstanceName en una cadena vacía ("").

Este constructor inicializa el contador de rendimiento y asocia la instancia a un contador existente (ya sea personalizado o del sistema) en el equipo local. Los valores que se pasen para las propiedades CategoryName y CounterName deben apuntar a un contador de rendimiento existente en el equipo local. Si la instancia de contador de rendimiento a la que se apunta no es válida, cuando se llama al constructor se produce una excepción.

NotaNota

Puede utilizar esta sobrecarga para conectarse a un contador del sistema, pero no puede escribir en él. Por lo tanto, si readOnly está establecido en false al conectarse a un contador del sistema, el constructor produce una excepción.

NotaNota

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 sistema 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á el rol 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. Podrá hacerlo cuando inicie una aplicación haciendo clic con el botón secundario en el icono de la aplicación e indicando que desea ejecutarla como administrador.

En el siguiente ejemplo de código se crea una instancia de la clase PerformanceCounter. El ejemplo pasa los nombres de categoría, nombres de contador y un valor de marcador 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 clase PerformanceCounter.

No hay ningún ejemplo de código disponible o este idioma no es compatible.

.NET Framework

Compatible con: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft