PerformanceCounter.InstanceName Propiedad

Definición

Espacio de nombres:

System.Diagnostics

Ensamblado:

System.Diagnostics.PerformanceCounter.dll

Paquete:

System.Diagnostics.PerformanceCounter v8.0.0

Source:

PerformanceCounter.cs

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

public:
 property System::String ^ InstanceName { System::String ^ get(); void set(System::String ^ value); };

public string InstanceName { get; set; }

member this.InstanceName : string with get, set

Public Property InstanceName As String

Valor de propiedad

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.

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

Nota

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

En algunas situaciones, las categorías se subdividen en instancias, que realizan un seguimiento de los datos sobre varias apariciones del objeto al que se relaciona una categoría. Las instancias se aplican a la categoría en su conjunto, en lugar de a contadores individuales. Cada contador de una categoría tiene cada instancia definida para la categoría. Por ejemplo, la categoría Proceso contiene instancias denominadas Idle y System. Cada contador dentro de la categoría Proceso contiene así datos para cada instancia, mostrando información sobre procesos inactivos o 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 esta PerformanceCounter instancia apunta a una categoría no personalizada, solo puede elegir entre las instancias de categoría existentes. Puede crear nuevas instancias de categoría solo en categorías personalizadas, lo que le permite definir tantos contadores como instancias de categoría según sea necesario.

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

Nota

No use los caracteres "(", ")", "#", "\" o "/" en el nombre de instancia. Si se usa alguno de estos caracteres, es posible que la Consola de rendimiento (consulte Generación de perfiles en tiempo de ejecución) no muestre 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
(	[
)	]
#	_
\	_
/	_

La FriendlyName propiedad del AppDomain objeto obtenido de la AppDomain.CurrentDomain propiedad es un origen común de nombres de instancia que pueden contener caracteres no válidos.