CounterSet.CreateCounterSetInstance(String) Méthode

Définition

Espace de noms:

System.Diagnostics.PerformanceData

Assembly:

System.Diagnostics.PerformanceCounter.dll

Paquet:

System.Diagnostics.PerformanceCounter v8.0.0

Source:

CounterSet.cs

Crée une instance de l'ensemble de compteurs.

public:
 System::Diagnostics::PerformanceData::CounterSetInstance ^ CreateCounterSetInstance(System::String ^ instanceName);

public System.Diagnostics.PerformanceData.CounterSetInstance CreateCounterSetInstance (string instanceName);

member this.CreateCounterSetInstance : string -> System.Diagnostics.PerformanceData.CounterSetInstance

Public Function CreateCounterSetInstance (instanceName As String) As CounterSetInstance

Paramètres

instanceName

String

Nom de l'instance. Le nom doit être unique.

Retours

CounterSetInstance

Instance de l'ensemble de compteurs qui contiendra les données de compteur.

Exceptions

ArgumentException

Le nom de l'instance est NULL.

InvalidOperationException

Vous devez ajouter des compteurs à l'ensemble de compteurs avant d'avoir créé une instance de l'ensemble de compteurs.

Exemples

Pour obtenir un exemple, consultez System.Diagnostics.PerformanceData.

Remarques

Appelez cette méthode une fois pour les ensembles de compteurs instance uniques et une ou plusieurs fois pour les ensembles de compteurs instance multiples.

Le fournisseur détermine quand il crée une instance. Si les données du compteur sont plus statiques, le fournisseur peut créer une instance au moment de l’initialisation. Par exemple, le nombre de processeurs sur un ordinateur serait considéré comme statique, de sorte qu’un fournisseur qui fournit des données de compteur pour les processeurs pourrait créer une instance pour chaque processeur sur l’ordinateur au moment de l’initialisation. Pour les compteurs plus dynamiques, tels que les compteurs de disque ou de processus, les fournisseurs créent les nouvelles instances en réponse à l’ajout d’un nouveau périphérique USB ou à la création d’un nouveau processus.

Le fournisseur doit maintenir les données du compteur à jour à tout moment.