PerformanceCounterCategory.ReadCategory Méthode

Définition

Espace de noms:

System.Diagnostics

Assembly:

System.Diagnostics.PerformanceCounter.dll

Paquet:

System.Diagnostics.PerformanceCounter v8.0.0

Source:

PerformanceCounterCategory.cs

Lit toutes les données de l'instance de l'objet de compteur et de performance associées à cette catégorie de compteurs de performance.

public:
 System::Diagnostics::InstanceDataCollectionCollection ^ ReadCategory();

public System.Diagnostics.InstanceDataCollectionCollection ReadCategory ();

member this.ReadCategory : unit -> System.Diagnostics.InstanceDataCollectionCollection

Public Function ReadCategory () As InstanceDataCollectionCollection

Retours

InstanceDataCollectionCollection

InstanceDataCollectionCollection contenant les données de l'instance de l'objet de compteur et de performance pour cette catégorie.

Exceptions

InvalidOperationException

La propriété CategoryName a la valeur null. Il se peut que la propriété ne soit pas définie.

Win32Exception

Échec de l'appel à une API système sous-jacente.

UnauthorizedAccessException

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

Exemples

L’exemple de code suivant crée un PerformanceCounterCategory pour un nom spécifié PerformanceCounterCategory . Il utilise ReadCategory ensuite pour retourner un InstanceDataCollectionCollection qui contient instance données pour toutes les instances des PerformanceCounter objets dans le PerformanceCounterCategory.

// Process the InstanceDataCollectionCollection for this category.
PerformanceCounterCategory pcc = new PerformanceCounterCategory(categoryName);
InstanceDataCollectionCollection idColCol = pcc.ReadCategory();
InstanceDataCollection[] idColArray = new InstanceDataCollection[idColCol.Count];

Console.WriteLine("InstanceDataCollectionCollection for \"{0}\" " +
    "has {1} elements.", categoryName, idColCol.Count);

' Process the InstanceDataCollectionCollection for this category.
Dim pcc As New PerformanceCounterCategory(categoryName)
Dim idColCol As InstanceDataCollectionCollection = pcc.ReadCategory()
Dim idColArray(idColCol.Count - 1) As InstanceDataCollection

Console.WriteLine("InstanceDataCollectionCollection for ""{0}"" " & _
    "has {1} elements.", categoryName, idColCol.Count)

Remarques

Vous devez définir la CategoryName propriété avant d’appeler ReadCategory.

La lecture de la catégorie entière à la fois peut être aussi efficace que la lecture d’un compteur unique en raison de la façon dont le système fournit les données.

Notes

Pour lire les compteurs de performances d’une session de connexion non interactive dans Windows Vista et versions ultérieures, 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 et versions ultérieures, ajoutez-vous au groupe Utilisateurs Analyseur de performances.

Dans Windows Vista et version ultérieure, 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.

Voir aussi

• InstanceDataCollectionCollection
• InstanceDataCollection
• InstanceData