PerformanceCounter.CounterType Propriété

Définition

Obtient le type de compteur du compteur de performance associé.

public:
 property System::Diagnostics::PerformanceCounterType CounterType { System::Diagnostics::PerformanceCounterType get(); };
public System.Diagnostics.PerformanceCounterType CounterType { get; }
member this.CounterType : System.Diagnostics.PerformanceCounterType
Public ReadOnly Property CounterType As PerformanceCounterType

Valeur de propriété

PerformanceCounterType décrivant la manière dont le compteur interagit avec une application de surveillance et la nature des valeurs qu'il contient (par exemple, calculées ou non calculées).

Exceptions

L'instance n'est pas correctement associée à un compteur de performance.

- ou -

La propriété InstanceLifetime a la valeur Process lorsqu'elle utilise la mémoire partagée globale.

Code s'exécutant sans privilèges d'administrateur, destiné à lire un compteur de performance.

Remarques

L’énumération PerformanceCounterType contient les types de compteurs de performances avec lesquels vous pouvez interagir. Certains des types de compteurs représentent des valeurs calculées, telles que la moyenne des mesures de compteur prises par le système. Les autres types représentent des valeurs brutes ou non calculées. Le tableau suivant montre les types de compteurs avec lesquels vous allez interagir le plus fréquemment.

Responsabilité du compteur Valeur PerformanceCounterType  Exemple
Conservez un nombre simple d’éléments ou d’opérations. NumberOfItems32 Suivi du nombre de commandes reçues sous forme d’entier 32 bits.
Conservez un nombre de simples de capacité supérieure. NumberOfItems64 Suivi du nombre de commandes pour un site avec un volume très élevé, stocké sous forme d’entier 64 bits.
Suivez le nombre d’éléments ou d’opérations par seconde. RateOfCountsPerSecond32 Suivi des commandes reçues par seconde sur un site.
Suivez un nombre plus élevé d’éléments ou d’opérations par seconde. RateOfCountsPerSecond64 Suivi des commandes reçues par seconde sur un site avec un volume très élevé.
Calculer la durée moyenne d’exécution d’un processus ou de traitement d’un élément AverageTimer32 Calculez la durée moyenne de traitement d’une commande.

Lorsque vous créez un compteur dont le type nécessite l’utilisation d’un compteur de base correspondant, vous devez déclarer le compteur et la base dans le CounterCreationDataCollection que vous passez dans la PerformanceCounterCategory.Create méthode.

Notes

Si la valeur de la InstanceLifetime propriété est Process et que la catégorie de compteur de performances a été créée avec .NET Framework version 1.0 ou 1.1, une InvalidOperationException valeur est levée. Les catégories de compteurs de performances créées avec des versions antérieures utilisent la mémoire partagée globale, et la valeur pour InstanceLifetime doit être Global. Si la catégorie n’est pas utilisée par les applications s’exécutant sur les versions 1.0 ou 1.1 du .NET Framework, supprimez et recréez la catégorie.

Notes

Pour lire les compteurs de performances dans Windows Vista, Windows XP Professionnel Édition x64 ou Windows Server 2003, vous devez être membre du groupe Utilisateurs Analyseur de performances ou disposer de privilèges d’administrateur.

Pour éviter d’avoir à élever vos privilèges pour accéder aux compteurs de performances dans Windows Vista, ajoutez-vous au groupe utilisateurs Analyseur de performances.

Dans Windows Vista, le contrôle de compte d'utilisateur détermine les privilèges d'un utilisateur. Si vous êtes membre du groupe Administrateurs intégrés, deux jetons d'accès au moment de l'exécution vous sont assignés : un jeton d'accès utilisateur standard et un jeton d'accès administrateur. Par défaut, vous êtes dans le rôle d'utilisateur standard. Pour exécuter le code qui accède aux compteurs de performances, vous devez d’abord élever vos privilèges d’utilisateur standard à administrateur. Vous pouvez effectuer cela au démarrage d'une application en cliquant avec le bouton droit sur l'icône de l'application et en indiquant que vous voulez l'exécuter en tant qu'administrateur.

S’applique à

Voir aussi