Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Propiedad PerformanceCounter.InstanceName

 

Publicado: octubre de 2016

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=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
[SettingsBindableAttribute(true)]
public string InstanceName { get; set; }

Valor de propiedad

Type: System.String

El nombre de la instancia de categoría del contador de rendimiento o una cadena vacía (""), si el contador es un contador de instancia única.

System_CAPS_noteNota

Nombres de instancia deben tener menos de 128 caracteres de longitud.

En algunas situaciones, las categorías se subdividen en instancias, que realizan un seguimiento de los datos sobre varias apariciones del objeto que está relacionado con una categoría. Instancias se aplican a la categoría como un todo, en lugar de los contadores individuales. Todos los contadores dentro de una categoría tienen definidas las instancias para la categoría. Por ejemplo, la categoría proceso contiene instancias Idle y System. Por lo tanto, cada contador de la categoría de proceso contiene datos para cada instancia, que muestra información sobre los procesos inactivos o los procesos del sistema.

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

Si este PerformanceCounter instancia apunta a una categoría no personalizada, puede elegir únicamente las instancias de categoría existentes. Puede crear nuevas instancias de categoría únicamente en categorías personalizadas, que le permiten definir como muchos contadores y categoría instancias como sea necesario.

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

System_CAPS_noteNota

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

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

Carácter

Carácter asignado

(

[

)

]

#

_

\

_

/

_

El FriendlyName propiedad de la AppDomain objeto obtenido de la AppDomain.CurrentDomain propiedad es un origen común de los nombres de instancia puede contener caracteres no válidos.

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

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

.NET Framework
Disponible desde 1.1
Volver al principio
Mostrar: