PerformanceCounter Constructores

Definición

Espacio de nombres:

System.Diagnostics

Ensamblado:

System.Diagnostics.PerformanceCounter.dll

Paquete:

System.Diagnostics.PerformanceCounter v8.0.0

Inicializa una nueva instancia de la clase PerformanceCounter.

Sobrecargas

PerformanceCounter()	Inicializa una nueva instancia de sólo lectura de la clase PerformanceCounter, sin asociar la instancia a ningún contador de rendimiento del sistema o personalizado.
PerformanceCounter(String, String)	Inicializa una nueva instancia de sólo lectura 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 tenga una sola instancia.
PerformanceCounter(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.
PerformanceCounter(String, String, String)	Inicializa una nueva instancia de sólo lectura de la clase PerformanceCounter y la asocia al contador de rendimiento personalizado o del sistema y a la instancia de categoría especificados en el equipo local.
PerformanceCounter(String, 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 y a la instancia de categoría especificados en el equipo local.
PerformanceCounter(String, String, String, String)	Inicializa una nueva instancia de sólo lectura de la clase PerformanceCounter y la asocia al contador de rendimiento personalizado o del sistema y a la instancia de categoría indicados en el equipo especificado.

PerformanceCounter()

Source:

PerformanceCounter.cs

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

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 , y se muestran los resultados de una llamada al NextValue método .

PerformanceCounter^ PC = gcnew PerformanceCounter;
PC->CategoryName = "Process";
PC->CounterName = "Private Bytes";
PC->InstanceName = "Explorer";
MessageBox::Show( PC->NextValue().ToString() );

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 en false.

Nota

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

PerformanceCounter(String, String)

Source:

PerformanceCounter.cs

Inicializa una nueva instancia de sólo lectura 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 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) a la que está asociado este contador de rendimiento.

counterName

String

El 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 de varias instancias y requiere que el contador de rendimiento se cree con un nombre de instancia.

o bien

categoryName y counterName se han localizado en distintos idiomas.

ArgumentNullException

categoryName o counterName es null.

Win32Exception

Error de acceso a la API del sistema.

UnauthorizedAccessException

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

Comentarios

Las cadenas de parámetros 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 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 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.

PerformanceCounter(String, String, Boolean)

Source:

PerformanceCounter.cs

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.

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) a la que está asociado este contador de rendimiento.

counterName

String

El nombre del contador de rendimiento.

readOnly

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.

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

o bien

categoryName y counterName se han localizado en distintos idiomas.

ArgumentNullException

categoryName o counterName es null.

Win32Exception

Error de acceso a la API del sistema.

UnauthorizedAccessException

Código que se ejecuta sin privilegios administrativos para intentar 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 .

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

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

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

Comentarios

Las cadenas de parámetros 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 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 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.

PerformanceCounter(String, String, String)

Source:

PerformanceCounter.cs

Inicializa una nueva instancia de sólo lectura de la clase PerformanceCounter y la asocia al contador de rendimiento personalizado o del sistema y a la instancia de categoría especificados 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) a la que está asociado este contador de rendimiento.

counterName

String

El nombre del contador de rendimiento.

instanceName

String

Nombre de la instancia de categoría del contador de rendimiento; o bien, 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 de varias instancias 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 distintos idiomas.

ArgumentNullException

categoryName o counterName es null.

Win32Exception

Error de acceso a la API del sistema.

UnauthorizedAccessException

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

Comentarios

Las cadenas de parámetros 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 acceder 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 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 Usuarios de 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 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 los 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.

PerformanceCounter(String, String, String, Boolean)

Source:

PerformanceCounter.cs

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 y a la instancia de categoría especificados 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) a la que está asociado este contador de rendimiento.

counterName

String

El nombre del contador de rendimiento.

instanceName

String

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

readOnly

Boolean

Este atributo se establece en true para obtener acceso a un contador en modo de sólo lectura; se establece en false para obtener acceso 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 permiso 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 de varias instancias 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 distintos idiomas.

ArgumentNullException

categoryName o counterName es null.

Win32Exception

Error de acceso a la API del sistema.

UnauthorizedAccessException

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

Comentarios

Las cadenas de parámetros 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, establecer readOnly en false al conectarse a un contador del sistema hace que el constructor produzca 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 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 Usuarios de 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 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 los 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.

PerformanceCounter(String, String, String, String)

Source:

PerformanceCounter.cs

Inicializa una nueva instancia de sólo lectura de la clase PerformanceCounter y la asocia al contador de rendimiento personalizado o del sistema y a la instancia de categoría indicados 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) a la que está asociado este contador de rendimiento.

counterName

String

El nombre del contador de rendimiento.

instanceName

String

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

machineName

String

Equipo en el que residen 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 permiso 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 de varias instancias 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 distintos idiomas.

ArgumentException

El parámetro machineName no es válido.

ArgumentNullException

categoryName o counterName es null.

Win32Exception

Error de acceso a la API del sistema.

UnauthorizedAccessException

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

Comentarios

Las cadenas de parámetros 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 acceder 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 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 Usuarios de 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 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 los 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.

Nota

En Windows Vista, cuando el equipo remoto es miembro de un grupo de trabajo, es posible que tenga que 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.