PerformanceCounter Constructores

Definición

Espacio de nombres:

System.Diagnostics

Ensamblado:

System.Diagnostics.PerformanceCounter.dll

Inicializa una nueva instancia de la clase PerformanceCounter.

Sobrecargas

Nombre	Description
PerformanceCounter()	Inicializa una nueva instancia de solo lectura de la PerformanceCounter clase, sin asociar la instancia a ningún contador de rendimiento personalizado o del sistema.
PerformanceCounter(String, String)	Inicializa una nueva instancia de solo lectura de la PerformanceCounter clase y la asocia al sistema especificado o al contador de rendimiento personalizado en el equipo local. Este constructor requiere que la categoría tenga una sola instancia.
PerformanceCounter(String, String, Boolean)	Inicializa una nueva instancia de solo lectura o de solo lectura y escritura de la PerformanceCounter clase y la asocia al sistema especificado o al contador de rendimiento personalizado en el equipo local. Este constructor requiere que la categoría contenga una sola instancia.
PerformanceCounter(String, String, String)	Inicializa una nueva instancia de solo lectura de la PerformanceCounter clase y la asocia con el sistema especificado o el contador de rendimiento personalizado y la instancia de categoría en el equipo local.
PerformanceCounter(String, String, String, Boolean)	Inicializa una nueva instancia de solo lectura o de solo lectura y escritura de la PerformanceCounter clase y la asocia con el sistema especificado, el contador de rendimiento personalizado y la instancia de categoría en el equipo local.
PerformanceCounter(String, String, String, String)	Inicializa una nueva instancia de solo lectura de la PerformanceCounter clase y la asocia al sistema especificado o a la instancia de categoría y contador de rendimiento personalizados, en el equipo especificado.

PerformanceCounter()

Source:

PerformanceCounter.cs

Inicializa una nueva instancia de solo lectura de la PerformanceCounter clase, sin asociar la instancia a ningún contador de rendimiento personalizado o del sistema.

public:
 PerformanceCounter();

public PerformanceCounter();

Public Sub New ()

Ejemplos

En el ejemplo de código siguiente se crea una instancia predeterminada de la PerformanceCounter clase . Una vez creada la instancia, se establecen los CategoryNamevalores de propiedad , CounterNamey InstanceName se muestran los resultados de una llamada al NextValue método .

PerformanceCounter performanceCounter = new PerformanceCounter();
performanceCounter.CategoryName = "Process";
performanceCounter.CounterName = "Private Bytes";
performanceCounter.InstanceName = "Explorer";
MessageBox.Show(performanceCounter.NextValue().ToString());

Dim PC As New PerformanceCounter()
PC.CategoryName = "Process"
PC.CounterName = "Private Bytes"
PC.InstanceName = "Explorer"
MessageBox.Show(PC.NextValue().ToString())

Comentarios

Esta sobrecarga del constructor establece las CategoryNamepropiedades , CounterNamey InstanceName en cadenas vacías (""), y establece la MachineName propiedad en el equipo local (".").

Este constructor no inicializa el contador de rendimiento, por lo que no asocia la instancia a un contador existente en el equipo local. Para apuntar a un contador de rendimiento específico, establezca , CounterNameCategoryNamey, opcionalmente, las InstanceName propiedades y MachineName antes de leer cualquier otra propiedad o intentar leer desde un contador. Para escribir en un contador de rendimiento, establezca la ReadOnly propiedad falseen .

Nota:

El HostProtectionAttribute atributo aplicado a este miembro tiene el siguiente Resources valor de propiedad: Synchronization | SharedState. No HostProtectionAttribute afecta a las aplicaciones de escritorio (que normalmente se inician haciendo doble clic en un icono, escribiendo un comando o escribiendo una dirección URL en un explorador). Para obtener más información, consulte la clase o los HostProtectionAttributeatributos de programación y protección de host de SQL Server.

PerformanceCounter(String, String)

Source:

PerformanceCounter.cs

Inicializa una nueva instancia de solo lectura de la PerformanceCounter clase y la asocia al sistema especificado o al contador de rendimiento personalizado en el equipo local. Este constructor requiere que la categoría tenga una sola instancia.

public:
 PerformanceCounter(System::String ^ categoryName, System::String ^ counterName);

public PerformanceCounter(string categoryName, string counterName);

new System.Diagnostics.PerformanceCounter : string * string -> System.Diagnostics.PerformanceCounter

Public Sub New (categoryName As String, counterName As String)

Parámetros

categoryName

String

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

counterName

String

Nombre del contador de rendimiento.

Excepciones

InvalidOperationException

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

O bien

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

O bien

La categoría especificada no existe.

O bien

La categoría especificada se marca como instancia múltiple y requiere que el contador de rendimiento se cree con un nombre de instancia.

O bien

categoryName y counterName se han localizado en diferentes idiomas.

ArgumentNullException

categoryName o counterName es null.

Win32Exception

Error al acceder a una API del sistema.

UnauthorizedAccessException

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

Comentarios

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

Use esta sobrecarga para acceder a un contador en el equipo local que pertenece a una categoría que contiene una única instancia de categoría de contador de rendimiento. Si intenta usar este constructor para apuntar esta PerformanceCounter instancia a una categoría que contiene varias instancias, el constructor produce una excepción. Esta sobrecarga puede tener acceso a cualquier contador de solo lectura o de lectura y escritura, pero lo hace en modo de solo lectura. Una PerformanceCounter instancia creada con esta sobrecarga no puede escribir en el contador, incluso si el propio contador es de lectura y escritura.

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

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 local. Los valores que se pasan para las CategoryName propiedades y CounterName deben apuntar a un contador de rendimiento existente en el equipo local.

Nota:

Para leer los contadores de rendimiento de una sesión de inicio de sesión no interactiva en Windows Vista y versiones posteriores, 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 acceder 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 asignan dos tokens de acceso en tiempo de ejecución: un token de acceso de usuario estándar y un token de acceso de administrador. De forma predeterminada, está en el rol de usuario estándar. Para ejecutar el código que accede a los contadores de rendimiento, primero debe elevar sus privilegios de usuario estándar a administrador. Puede hacerlo al iniciar una aplicación haciendo clic con el botón derecho en el icono de la aplicación e indicando que desea ejecutar como administrador.

PerformanceCounter(String, String, Boolean)

Source:

PerformanceCounter.cs

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

public:
 PerformanceCounter(System::String ^ categoryName, System::String ^ counterName, bool readOnly);

public PerformanceCounter(string categoryName, string counterName, bool readOnly);

new System.Diagnostics.PerformanceCounter : string * string * bool -> System.Diagnostics.PerformanceCounter

Public Sub New (categoryName As String, counterName As String, readOnly As Boolean)

Parámetros

categoryName

String

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

counterName

String

Nombre del contador de rendimiento.

readOnly

Boolean

true para acceder al contador en modo de solo lectura (aunque el propio contador podría ser de lectura y escritura); false para acceder al contador en modo de lectura y escritura.

Excepciones

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 instancia múltiple y requiere que el contador de rendimiento se cree con un nombre de instancia.

O bien

categoryName y counterName se han localizado en diferentes idiomas.

ArgumentNullException

categoryName o counterName es null.

Win32Exception

Error al acceder a una API del sistema.

UnauthorizedAccessException

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

Ejemplos

En el ejemplo de código siguiente se crea una instancia de la PerformanceCounter clase . En el ejemplo se pasan nombres de categoría, nombres de contador y un valor de marca que indica que el contador no es de solo lectura. Este ejemplo de código forma parte de un ejemplo más grande para la PerformanceCounter clase .

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

avgCounter64Sample = New PerformanceCounter("AverageCounter64SampleCategory", "AverageCounter64Sample", False)

Comentarios

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

Use esta sobrecarga para acceder a un contador de solo lectura o de lectura y escritura en el equipo local que pertenece a una categoría que contiene una única instancia de categoría de contador de rendimiento. Si intenta usar este constructor para apuntar esta PerformanceCounter instancia a una categoría que contiene varias instancias, el constructor produce una excepción.

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

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 local. Los valores que se pasan para las CategoryName propiedades y CounterName deben apuntar a un contador de rendimiento existente en el equipo local. Si la instancia del contador de rendimiento a la que apunta no es válida, al llamar al constructor se produce una excepción.

Nota:

Puede usar esta sobrecarga para conectarse a un contador del sistema, pero no puede escribir en un contador del sistema. Por lo tanto, al establecer readOnly en false al conectarse a un contador del sistema, el constructor produce una excepción.

Nota:

Para leer los contadores de rendimiento de una sesión de inicio de sesión no interactiva en Windows Vista y versiones posteriores, 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 acceder 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 asignan dos tokens de acceso en tiempo de ejecución: un token de acceso de usuario estándar y un token de acceso de administrador. De forma predeterminada, está en el rol de usuario estándar. Para ejecutar el código que accede a los contadores de rendimiento, primero debe elevar sus privilegios de usuario estándar a administrador. Puede hacerlo al iniciar una aplicación haciendo clic con el botón derecho en el icono de la aplicación e indicando que desea ejecutar como administrador.

PerformanceCounter(String, String, String)

Source:

PerformanceCounter.cs

Inicializa una nueva instancia de solo lectura de la PerformanceCounter clase y la asocia con el sistema especificado o el contador de rendimiento personalizado y la instancia de categoría en el equipo local.

public:
 PerformanceCounter(System::String ^ categoryName, System::String ^ counterName, System::String ^ instanceName);

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

new System.Diagnostics.PerformanceCounter : string * string * string -> System.Diagnostics.PerformanceCounter

Public Sub New (categoryName As String, counterName As String, instanceName As String)

Parámetros

categoryName

String

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

counterName

String

Nombre del contador de rendimiento.

instanceName

String

Nombre de la instancia de categoría del contador de rendimiento o una cadena vacía (""), si la categoría contiene una sola instancia.

Excepciones

InvalidOperationException

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

O bien

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

O bien

La categoría especificada no es válida.

O bien

La categoría especificada se marca como instancia múltiple y requiere que el contador de rendimiento se cree con un nombre de instancia.

O bien

instanceName tiene más de 127 caracteres.

O bien

categoryName y counterName se han localizado en diferentes idiomas.

ArgumentNullException

categoryName o counterName es null.

Win32Exception

Error al acceder a una API del sistema.

UnauthorizedAccessException

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

Comentarios

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

Esta sobrecarga del constructor establece las CategoryNamepropiedades , CounterNamey InstanceName en los valores que se pasan y establece la MachineName propiedad en el equipo local, ".".

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 local. Los valores que se pasan para las CategoryNamepropiedades , CounterNamey InstanceName deben apuntar a un contador de rendimiento existente en el equipo local. Si la instancia del contador de rendimiento a la que apunta no es válida, al llamar al constructor se produce una excepción.

Esta sobrecarga puede tener acceso a cualquier contador de solo lectura o de lectura y escritura, pero lo hace en modo de solo lectura. Una PerformanceCounter instancia creada con esta sobrecarga no puede escribir en el contador, incluso si el propio contador es de lectura y escritura.

Para crear una instancia de categoría de rendimiento, especifique en instanceName 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.

Nota:

Para leer 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 acceder 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 asignan dos tokens de acceso en tiempo de ejecución: un token de acceso de usuario estándar y un token de acceso de administrador. De forma predeterminada, está en el rol de usuario estándar. Para ejecutar el código que accede a los contadores de rendimiento, primero debe elevar sus privilegios de usuario estándar a administrador. Puede hacerlo al iniciar una aplicación haciendo clic con el botón derecho en el icono de la aplicación e indicando que desea ejecutar como administrador.

PerformanceCounter(String, String, String, Boolean)

Source:

PerformanceCounter.cs

Inicializa una nueva instancia de solo lectura o de solo lectura y escritura de la PerformanceCounter clase y la asocia con el sistema especificado, el contador de rendimiento personalizado y la instancia de categoría en el equipo local.

public:
 PerformanceCounter(System::String ^ categoryName, System::String ^ counterName, System::String ^ instanceName, bool readOnly);

public PerformanceCounter(string categoryName, string counterName, string instanceName, bool readOnly);

new System.Diagnostics.PerformanceCounter : string * string * string * bool -> System.Diagnostics.PerformanceCounter

Public Sub New (categoryName As String, counterName As String, instanceName As String, readOnly As Boolean)

Parámetros

categoryName

String

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

counterName

String

Nombre del contador de rendimiento.

instanceName

String

Nombre de la instancia de categoría del contador de rendimiento o una cadena vacía (""), si la categoría contiene una sola instancia.

readOnly

Boolean

true para acceder a un contador en modo de solo lectura; false para acceder a un contador en modo de lectura y escritura.

Excepciones

InvalidOperationException

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

O bien

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

O bien

La configuración de permisos de lectura y escritura solicitada no es válida para este contador.

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 instancia múltiple y requiere que el contador de rendimiento se cree con un nombre de instancia.

O bien

instanceName tiene más de 127 caracteres.

O bien

categoryName y counterName se han localizado en diferentes idiomas.

ArgumentNullException

categoryName o counterName es null.

Win32Exception

Error al acceder a una API del sistema.

UnauthorizedAccessException

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

Comentarios

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

Use esta sobrecarga para acceder a un contador de rendimiento en modo de solo lectura o de lectura y escritura.

Esta sobrecarga del constructor establece las CategoryNamepropiedades , CounterNamey InstanceName en los valores que se pasan, y establece la MachineName propiedad en el equipo local, ".".

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 local. Los valores que se pasan para las CategoryNamepropiedades , CounterNamey InstanceName deben apuntar a un contador de rendimiento existente en el equipo local. Si la instancia del contador de rendimiento a la que apunta no es válida, al llamar al constructor se produce una excepción.

Nota:

Puede usar esta sobrecarga para conectarse a un contador del sistema, pero no puede escribir en un contador del sistema. Por lo tanto, al establecer readOnly en false al conectarse a un contador del sistema, el constructor produce una excepción.

Para crear una instancia de categoría de rendimiento, especifique en instanceName 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.

Nota:

Para leer 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 acceder 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 asignan dos tokens de acceso en tiempo de ejecución: un token de acceso de usuario estándar y un token de acceso de administrador. De forma predeterminada, está en el rol de usuario estándar. Para ejecutar el código que accede a los contadores de rendimiento, primero debe elevar sus privilegios de usuario estándar a administrador. Puede hacerlo al iniciar una aplicación haciendo clic con el botón derecho en el icono de la aplicación e indicando que desea ejecutar como administrador.

PerformanceCounter(String, String, String, String)

Source:

PerformanceCounter.cs

Inicializa una nueva instancia de solo lectura de la PerformanceCounter clase y la asocia al sistema especificado o a la instancia de categoría y contador de rendimiento personalizados, en el equipo especificado.

public:
 PerformanceCounter(System::String ^ categoryName, System::String ^ counterName, System::String ^ instanceName, System::String ^ machineName);

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

new System.Diagnostics.PerformanceCounter : string * string * string * string -> System.Diagnostics.PerformanceCounter

Public Sub New (categoryName As String, counterName As String, instanceName As String, machineName As String)

Parámetros

categoryName

String

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

counterName

String

Nombre del contador de rendimiento.

instanceName

String

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

String

Equipo en el que existe el contador de rendimiento y su categoría asociada.

Excepciones

InvalidOperationException

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

O bien

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

O bien

La configuración de permisos de lectura y escritura solicitada no es válida para este contador.

O bien

El contador no existe en el equipo especificado.

O bien

La categoría especificada se marca como instancia múltiple y requiere que el contador de rendimiento se cree con un nombre de instancia.

O bien

instanceName tiene más de 127 caracteres.

O bien

categoryName y counterName se han localizado en diferentes idiomas.

ArgumentException

El machineName parámetro no es válido.

ArgumentNullException

categoryName o counterName es null.

Win32Exception

Error al acceder a una API del sistema.

UnauthorizedAccessException

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

Comentarios

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

Esta sobrecarga del constructor establece las CategoryNamepropiedades , CounterName, InstanceNamey MachineName en los valores que se pasan.

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 pasan para las CategoryNamepropiedades , CounterNameInstanceName y MachineName deben apuntar a un contador de rendimiento existente. Si la instancia del contador de rendimiento a la que apunta no es válida, al llamar al constructor se produce una excepción. Esta sobrecarga puede tener acceso a cualquier contador de solo lectura o de lectura y escritura, pero lo hace en modo de solo lectura. Una PerformanceCounter instancia creada con esta sobrecarga no puede escribir en el contador, incluso si el propio contador es de lectura y escritura.

Nota:

No se puede escribir en contadores de rendimiento remotos. No hay ninguna sobrecarga que le permita 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 en instanceName 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.

Nota:

Para leer 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 acceder 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 asignan dos tokens de acceso en tiempo de ejecución: un token de acceso de usuario estándar y un token de acceso de administrador. De forma predeterminada, está en el rol de usuario estándar. Para ejecutar el código que accede a los contadores de rendimiento, primero debe elevar sus privilegios de usuario estándar a administrador. Puede hacerlo al iniciar una aplicación haciendo clic con el botón derecho en el icono de la aplicación e indicando que desea ejecutar como administrador.

Nota:

En Windows Vista, cuando el equipo remoto es miembro de un grupo de trabajo, es posible que deba deshabilitar UAC para que la cuenta de usuario local no se filtre y se pueda elevar a una cuenta de administrador. Por motivos de seguridad, deshabilitar UAC debe ser un último recurso. Para obtener información sobre cómo deshabilitar UAC, consulte Control de cuentas de usuario y WMI.