Partager via


CounterSet.CreateCounterSetInstance(String) Méthode

Définition

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);
[System.Security.SecurityCritical]
public System.Diagnostics.PerformanceData.CounterSetInstance CreateCounterSetInstance (string instanceName);
member this.CreateCounterSetInstance : string -> System.Diagnostics.PerformanceData.CounterSetInstance
[<System.Security.SecurityCritical>]
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

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

Attributs

Exceptions

Le nom de l'instance est NULL.

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.

S’applique à