PerformanceCounterCategory.ReadCategory Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Legge tutti i dati dell'istanza dell'oggetto prestazioni e del contatore delle prestazioni associati a questa categoria di contatori delle prestazioni.
public:
System::Diagnostics::InstanceDataCollectionCollection ^ ReadCategory();public System.Diagnostics.InstanceDataCollectionCollection ReadCategory();member this.ReadCategory : unit -> System.Diagnostics.InstanceDataCollectionCollectionPublic Function ReadCategory () As InstanceDataCollectionCollectionRestituisce
Oggetto InstanceDataCollectionCollection contenente i dati dell'istanza dell'oggetto prestazioni e del contatore per la categoria.
Eccezioni
La CategoryName proprietà è null. La proprietà potrebbe non essere stata impostata.
Chiamata a un'API di sistema sottostante non riuscita.
Codice in esecuzione senza privilegi amministrativi che ha tentato di leggere un contatore delle prestazioni.
Esempio
Nell'esempio di codice seguente viene creato un oggetto PerformanceCounterCategory per un nome specificato PerformanceCounterCategory . Viene quindi utilizzato ReadCategory per restituire un oggetto InstanceDataCollectionCollection che contiene i dati dell'istanza PerformanceCounter per tutte le istanze degli oggetti all'interno di 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)
Commenti
È necessario impostare la CategoryName proprietà prima di chiamare ReadCategory.
La lettura dell'intera categoria contemporaneamente può essere efficiente come la lettura di un singolo contatore a causa del modo in cui il sistema fornisce i dati.
Annotazioni
Per leggere i contatori delle prestazioni da una sessione di accesso non interattiva in Windows Vista e versioni successive, Windows XP Professional x64 Edition o Windows Server 2003, è necessario essere membri del gruppo Performance Monitor Users o disporre di privilegi amministrativi.
Per evitare di dover elevare i privilegi per accedere ai contatori delle prestazioni in Windows Vista e versioni successive, aggiungere se stessi al gruppo Utenti di Performance Monitor.
In Windows Vista e versioni successive, Controllo account utente determina i privilegi di un utente. Se si è membri del gruppo Administrators predefinito, vengono assegnati due token di accesso in fase di esecuzione: un token di accesso utente standard e un token di accesso amministratore. Per impostazione predefinita, si è nel ruolo utente standard. Per eseguire il codice che accede ai contatori delle prestazioni, è necessario innanzitutto elevare i privilegi dall'utente standard all'amministratore. A tale scopo, è possibile avviare un'applicazione facendo clic con il pulsante destro del mouse sull'icona dell'applicazione e indicando che si vuole eseguire come amministratore.
