PerformanceCounter.CounterType Propriété

Définition

Espace de noms:

System.Diagnostics

Assembly:

System.Diagnostics.PerformanceCounter.dll

Source:

PerformanceCounter.cs

Obtient le type de compteur du compteur de performances 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

Qui PerformanceCounterType décrit à la fois comment le compteur interagit avec une application de surveillance et la nature des valeurs qu’il contient (par exemple, calculé ou non calculé).

Exceptions

InvalidOperationException

L’instance n’est pas correctement associée à un compteur de performances.

- ou -

La InstanceLifetime propriété est définie Process lors de l’utilisation de la mémoire partagée globale.

UnauthorizedAccessException

Code en cours d’exécution sans privilèges d’administration tenté de lire un compteur de performances.

Remarques

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

Responsabilité du compteur	PerformanceCounterType, valeur	Exemple
Conservez un nombre simple d’éléments ou d’opérations.	NumberOfItems32	Suivi du nombre de commandes reçues sous la forme d’un entier 32 bits.
Conservez un nombre simple de capacité plus élevé.	NumberOfItems64	Suivi du nombre de commandes d’un site avec un volume très élevé, stocké sous la forme d’un 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.
Effectuez le suivi d’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 le temps moyen d’effectuer un processus ou de traiter un élément	AverageTimer32	Calculez la durée moyenne pendant laquelle une commande doit être traitée.

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 la CounterCreationDataCollection méthode que vous passez.PerformanceCounterCategory.Create

Note

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 InstanceLifetime pour laquelle 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.

Note

Pour lire les compteurs de performances dans Windows Vista, Windows XP Professional x64 Edition ou Windows Server 2003, vous devez être membre du groupe Utilisateurs de l’Analyseur de performances ou disposer de privilèges d’administration.

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

Dans Windows Vista, le contrôle de compte d’utilisateur (UAC) détermine les privilèges d’un utilisateur. Si vous êtes membre du groupe Administrateurs intégrés, vous disposez de deux jetons d’accès au moment de l’exécution : 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 de l’utilisateur standard à l’administrateur. Pour ce faire, lorsque vous démarrez une application, cliquez avec le bouton droit sur l’icône de l’application et indiquez que vous souhaitez exécuter en tant qu’administrateur.

Voir aussi

• PerformanceCounterType