Exportar (0) Imprimir
Expandir todo

PerformanceCounter.InstanceName (Propiedad)

Actualización: noviembre 2007

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

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

[TypeConverterAttribute("System.Diagnostics.Design.InstanceNameConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string InstanceName { get; set; }
/** @property */
/** @attribute TypeConverterAttribute("System.Diagnostics.Design.InstanceNameConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a") */
public String get_InstanceName()
/** @property */
/** @attribute TypeConverterAttribute("System.Diagnostics.Design.InstanceNameConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a") */
public  void set_InstanceName(String value)

public function get InstanceName () : String
public function set InstanceName (value : String)

Valor de propiedad

Tipo: System.String
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.

c9tw9haa.alert_note(es-es,VS.90).gifNota:

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.

c9tw9haa.alert_note(es-es,VS.90).gifNota:

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.

En el siguiente ejemplo de código se crea una instancia predeterminada de la clase PerformanceCounter. Una vez creada la instancia, se establecen los valores de las propiedades CategoryName, CounterName y InstanceName, y se muestran los resultados de una llamada al método NextValue.

			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 Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

.NET Framework

Compatible con: 3.5, 3.0, 2.0, 1.1, 1.0

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft