PerformanceCounter.InstanceName Propriété

Définition

Espace de noms:

System.Diagnostics

Assembly:

System.Diagnostics.PerformanceCounter.dll

Paquet:

System.Diagnostics.PerformanceCounter v8.0.0

Source:

PerformanceCounter.cs

Obtient ou définit un nom d'instance pour ce compteur de performance.

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

Valeur de propriété

String

Nom de l'instance de la catégorie de compteurs de performance, ou chaîne vide ("") si le compteur possède une seule instance.

Exemples

L’exemple de code suivant crée une instance par défaut de la PerformanceCounter classe . Une fois le instance créé, les valeurs de propriété CategoryName, CounterNameet InstanceName sont définies et les résultats d’un appel à la NextValue méthode s’affichent.

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())

Remarques

Notes

Les noms d’instance doivent avoir une longueur inférieure à 128 caractères.

Dans certaines situations, les catégories sont subdivées en instances, qui effectuent le suivi des données relatives à plusieurs occurrences de l’objet auquel une catégorie est liée. Les instances s’appliquent à la catégorie dans son ensemble, plutôt qu’à des compteurs individuels. Chaque compteur d’une catégorie a chaque instance défini pour la catégorie. Par exemple, la catégorie Processus contient des instances nommées Idle et System. Chaque compteur de la catégorie Processus contient donc des données pour chaque instance, montrant des informations sur les processus inactifs ou les processus système.

De nombreuses catégories ne contiennent pas plusieurs instances. Vous pouvez donc laisser cette propriété vide pour indiquer qu’aucune instance n’est associée à la catégorie.

Si cette PerformanceCounter instance pointe vers une catégorie non personnalisée, vous pouvez choisir parmi uniquement les instances de catégorie existantes. Vous pouvez créer de nouvelles instances de catégorie uniquement dans des catégories personnalisées, ce qui vous permet de définir autant de compteurs et d’instances de catégorie que nécessaire.

Pour créer une catégorie de performances instance, spécifiez un instanceName sur le PerformanceCounter constructeur. Si la catégorie instance spécifiée par instanceName existe déjà, le nouvel objet référencera la catégorie existante instance.

Notes

N’utilisez pas les caractères « (« , « ) », « # », « \ » ou « / » dans le nom instance. Si l’un de ces caractères est utilisé, la console de performances (voir Profilage d’exécution) peut ne pas afficher correctement les valeurs instance.

Si le nom du instance est généré automatiquement et peut contenir les caractères " (« (« , « ) », « # », « \ » ou « / », utilisez le mappage de caractères dans le tableau suivant.

Caractère	Caractère mappé
(	[
)	]
#	_
\	_
/	_

La FriendlyName propriété de l’objet AppDomain obtenu à partir de la AppDomain.CurrentDomain propriété est une source courante de noms instance qui peuvent contenir des caractères non valides.