Exportar (0) Imprimir
Expandir todo
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

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)

'Declaración
<SettingsBindableAttribute(True)> _
<TypeConverterAttribute("System.Diagnostics.Design.InstanceNameConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")> _
Public Property InstanceName As 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.

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.

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.


Dim PC As New PerformanceCounter()
PC.CategoryName = "Process"
PC.CounterName = "Private Bytes"
PC.InstanceName = "Explorer"
MessageBox.Show(PC.NextValue().ToString())


.NET Framework

Compatible con: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft