¿Le resultó útil esta página?
Sus comentarios sobre este contenido son muy importantes. Háganos saber su opinión.
¿Tiene comentarios adicionales?
Caracteres restantes: 1500
Exportar (0) Imprimir
Expandir todo

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)

public PerformanceCounter (
	string categoryName,
	string counterName,
	bool readOnly
)
public PerformanceCounter (
	String categoryName, 
	String counterName, 
	boolean readOnly
)
public function PerformanceCounter (
	categoryName : String, 
	counterName : String, 
	readOnly : boolean
)

Parámetros

categoryName

Nombre de la categoría de contador de rendimiento (objeto de rendimiento) a la que está asociado este contador de rendimiento.

counterName

Nombre del contador de rendimiento.

readOnly

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.

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

ArgumentNullException

Los parámetros categoryName o counterName son referencia de objeto null (Nothing en Visual Basic).

Win32Exception

Error al obtener acceso a una API del sistema.

PlatformNotSupportedException

La plataforma es Windows 98 o Windows Millennium Edition (Me), que no admiten contadores de rendimiento.

Las cadenas de parámetros no distinguen entre mayúsculas y 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.

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


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

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter Edition

.NET Framework no admite todas las versiones de cada plataforma. Para obtener una lista de las versiones admitidas, vea Requisitos del sistema.

.NET Framework

Compatible con: 2.0, 1.1, 1.0

Adiciones de comunidad

AGREGAR
Mostrar:
© 2015 Microsoft