PerformanceCounter.CounterType Proprietà

Definizione

Spazio dei nomi:

System.Diagnostics

Assembly:

System.Diagnostics.PerformanceCounter.dll

Origine:

PerformanceCounter.cs

Ottiene il tipo di contatore del contatore delle prestazioni associato.

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

Valore della proprietà

PerformanceCounterType

Oggetto PerformanceCounterType che descrive sia il modo in cui il contatore interagisce con un'applicazione di monitoraggio che con la natura dei valori contenuti, ad esempio calcolati o non calcolati.

Eccezioni

InvalidOperationException

L'istanza non è associata correttamente a un contatore delle prestazioni.

oppure

La InstanceLifetime proprietà viene impostata su Process quando si usa la memoria condivisa globale.

UnauthorizedAccessException

Codice in esecuzione senza privilegi amministrativi che ha tentato di leggere un contatore delle prestazioni.

Commenti

L'enumerazione PerformanceCounterType contiene i tipi di contatori delle prestazioni con cui è possibile interagire. Alcuni tipi di contatore rappresentano valori calcolati, ad esempio la media delle misurazioni del contatore prese dal sistema. Altri tipi rappresentano valori non elaborati o non calcolati. Nella tabella seguente vengono illustrati i tipi di contatore con cui si interagirà più frequentemente.

Responsabilità del contatore	Valore PerformanceCounterType	Esempio
Mantenere un semplice conteggio di elementi o operazioni.	NumberOfItems32	Rilevamento del numero di ordini ricevuti come intero a 32 bit.
Mantenere un numero semplice di capacità superiore.	NumberOfItems64	Rilevamento del numero di ordini per un sito con volume molto elevato, archiviato come intero a 64 bit.
Tenere traccia del numero di elementi o operazioni al secondo.	RateOfCountsPerSecond32	Rilevamento degli ordini ricevuti al secondo in un sito.
Tenere traccia di un numero di elementi o operazioni superiore al secondo.	RateOfCountsPerSecond64	Tenere traccia degli ordini ricevuti al secondo in un sito con volume molto elevato.
Calcolare il tempo medio per eseguire un processo o elaborare un elemento	AverageTimer32	Calcolare il tempo medio impiegato per l'elaborazione di un ordine.

Quando si crea un contatore il cui tipo richiede l'uso di un contatore di base corrispondente, è necessario dichiarare il contatore e la base nel CounterCreationDataCollection metodo passato PerformanceCounterCategory.Create .

Annotazioni

Se il valore della InstanceLifetime proprietà è Process e la categoria del contatore delle prestazioni è stata creata con .NET Framework versione 1.0 o 1.1, viene generata un'eccezione InvalidOperationException . Le categorie di contatori delle prestazioni create con le versioni precedenti usano la memoria condivisa globale e il valore per InstanceLifetime deve essere Global. Se la categoria non viene usata dalle applicazioni in esecuzione nelle versioni 1.0 o 1.1 di .NET Framework, eliminare e ricreare la categoria.

Annotazioni

Per leggere i contatori delle prestazioni in Windows Vista, 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, aggiungere se stessi al gruppo Utenti di Performance Monitor.

In Windows Vista il controllo dell'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.

Vedi anche

• PerformanceCounterType