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

System_CAPS_noteNota

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

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

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

public:
[TypeConverterAttribute("System.Diagnostics.Design.InstanceNameConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
[SettingsBindableAttribute(true)]
property String^ InstanceName {
	String^ get();
	void set(String^ value);
}

Valor de propiedad

Type: System::String^

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

System_CAPS_noteNota

Los nombres de instancia deben ser inferior a 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 de conjunto, en lugar de los contadores individuales. Cada contador dentro de una categoría tiene cada instancia definido para la categoría. Por ejemplo, la categoría de proceso contiene instancias denominadas inactivo y el sistema. Por lo tanto, cada contador dentro 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 no hay ninguna instancia está asociada a la categoría.

Si este PerformanceCounter instancia apunta a una categoría no personalizada, puede elegir solo 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ías instancias según 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 (vea Generar perfiles en tiempo de ejecución) no puede mostrar correctamente los valores de instancia.

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

Carácter

Carácter asignado

(

[

)

]

#

_

\

_

/

_

El FriendlyName propiedad de la AppDomain objeto obtenida de la AppDomain::CurrentDomain propiedad es una causa común de los nombres de instancia que 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, el CategoryName, CounterName, y InstanceName los valores de propiedad son conjunto y los resultados de una llamada a la NextValue método se muestran.

PerformanceCounter^ PC = gcnew 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: