PerformanceCounter.InstanceName (Propiedad)

Obtiene o establece un nombre de instancia para este contador de rendimiento.

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

public string InstanceName { get; set; }
/** @property */
public String get_InstanceName ()

/** @property */
public void set_InstanceName (String value)

public function get InstanceName () : String

public function set InstanceName (value : String)

Valor de propiedad

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

NotaNota

Los nombres de instancias deben tener una longitud inferior a 128 caracteres.

En algunas situaciones, las categorías se subdividen en instancias que realizan un seguimiento de datos en diversas apariciones del objeto con el que está relacionada una categoría. Las instancias se aplican a la categoría en conjunto, en lugar de aplicarse a contadores individuales. Todos los contadores de una categoría tienen todas y cada una de las instancias definidas para dicha categoría. Por ejemplo, la categoría Process contiene las instancias Idle y System. Por lo tanto, cada contador de la categoría Process contiene datos de cada instancia que muestran información sobre los procesos inactivos o los procesos del sistema.

Muchas categorías no contienen varias instancias, por lo que esta propiedad se puede dejar vacía para indicar que no hay ninguna instancia asociada a la categoría.

Si esta instancia de PerformanceCounter apunta a una categoría no personalizada, sólo se podrá elegir entre las instancias de categoría existentes. Se pueden crear nuevas instancias de categoría únicamente en las categorías personalizadas, que permiten definir todos los contadores e instancias de categoría que sean necesarios.

Para crear una instancia de categoría de rendimiento, especifique un instanceName en el constructor PerformanceCounter. Si la instancia de categoría especificada por instanceName ya existe, el nuevo objeto hará referencia a la instancia de categoría existente.

NotaNota

No utilice los caracteres "(", ")", "#", "\" o "/" en el nombre de instancia. Si se utiliza cualquiera de estos caracteres, la consola de rendimiento (vea Generar perfiles en tiempo de ejecución) quizás no pueda mostrar correctamente los valores de la instancia.

Si el nombre de instancia se genera automáticamente y es posible que contenga los caracteres "(", ")", "#", "\" o "/", utilice la asignación de caracteres de la tabla siguiente.

Carácter

Carácter asignado

(

[

)

]

#

_

\

_

/

_

La propiedad FriendlyName del objeto AppDomain que se obtiene a partir de la propiedad AppDomain.CurrentDomain es un origen habitual de nombres de instancia que pueden contener caracteres no válidos.

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

PerformanceCounter pc = new PerformanceCounter();
pc.set_CategoryName("Process");
pc.set_CounterName("Private Bytes");
pc.set_InstanceName("Explorer");
MessageBox.Show(((Single)pc.NextValue()).ToString());

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: