PerformanceCounter Constructores

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.

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

Excepciones

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.

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

Excepciones

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.

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

Excepciones

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 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 un instanceName en 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.

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

Excepciones

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.

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

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

Excepciones

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 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 un instanceName en 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.