PerformanceCounter.InstanceName Propriété

Définition

Espace de noms:

System.Diagnostics

Assembly:

System.Diagnostics.PerformanceCounter.dll

Source:

PerformanceCounter.cs

Obtient ou définit un nom d’instance pour ce compteur de performances.

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 catégorie de compteur de performances ou chaîne vide ( » « ), si le compteur est un compteur à instance unique.

Exemples

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

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

Note

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

Dans certaines situations, les catégories sont subdivises 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’aux compteurs individuels. Chaque compteur d’une catégorie a chaque instance définie pour la catégorie. Par exemple, la catégorie Processus contient des instances nommées Inactive 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 noncustome, vous pouvez choisir parmi uniquement les instances de catégorie existantes. Vous pouvez créer de nouvelles instances de catégorie uniquement dans les 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 instance de catégorie de performances, spécifiez un instanceName constructeur PerformanceCounter . Si l’instance de catégorie spécifiée par instanceName existe déjà, le nouvel objet référence l’instance de catégorie existante.

Note

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

Si le nom de l’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 commune de noms d’instances pouvant contenir des caractères non valides.