Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Costruttore PerformanceCounter (String, String, Boolean)

 

Data di pubblicazione: ottobre 2016

Inizializza una nuova, sola lettura o lettura/scrittura istanza la PerformanceCounter classe e lo associa al sistema specificato o al contatore delle prestazioni personalizzati nel computer locale. Il costruttore richiede che la categoria contiene una singola istanza.

Spazio dei nomi:   System.Diagnostics
Assembly:  System (in System.dll)

public PerformanceCounter(
	string categoryName,
	string counterName,
	bool readOnly
)

Parametri

categoryName
Type: System.String

Il nome della categoria del contatore delle prestazioni (oggetto prestazioni) a cui è associato questo contatore delle prestazioni.

counterName
Type: System.String

Il nome del contatore delle prestazioni.

readOnly
Type: System.Boolean

true Per accedere al contatore in modalità sola lettura (sebbene il contatore stesso può essere di lettura/scrittura); false per accedere al contatore in modalità lettura/scrittura.

Exception Condition
InvalidOperationException

Il categoryName è una stringa vuota ("").

-oppure-

Il counterName è una stringa vuota ("").

-oppure-

La categoria specificata non esiste. (if readOnly is true).

-oppure-

La categoria specificata non è una categoria personalizzata .NET Framework (se readOnly è false).

-oppure-

La categoria specificata è contrassegnata come istanza multipla e richiede il contatore delle prestazioni deve essere creato con un nome di istanza.

-oppure-

categoryName e counterName sono stati localizzati in lingue diverse.

ArgumentNullException

categoryName o counterName è null.

Win32Exception

Si è verificato un errore durante l'accesso a un'API di sistema.

PlatformNotSupportedException

La piattaforma è Windows 98 o Windows Millennium Edition (Me), che non supporta i contatori delle prestazioni.

UnauthorizedAccessException

Il codice che è in esecuzione senza privilegi di amministratore ha tentato di leggere un contatore delle prestazioni.

Le stringhe dei parametri non sono rilevanti.

Utilizzare questo overload per accedere in sola lettura o lettura/scrittura contatore del computer locale che appartiene a una categoria che contiene un'istanza di categoria del contatore delle prestazioni singolo. Se si tenta di utilizzare questo costruttore per puntare questa PerformanceCounter istanza a una categoria che contiene più istanze, il costruttore genera un'eccezione.

Questo overload del costruttore imposta la CategoryName, CounterName, e ReadOnly proprietà con i valori passati, imposta la MachineName proprietà nel computer locale, "." e imposta la InstanceName proprietà su una stringa vuota ("").

Questo costruttore inizializza il contatore delle prestazioni e associa l'istanza a un contatore esistente (un sistema o un contatore personalizzato) nel computer locale. I valori che si è passato per il CategoryName e CounterName proprietà devono puntare a un contatore delle prestazioni esistente nel computer locale. Se l'istanza del contatore delle prestazioni cui si punta non è valido, chiamare il costruttore genera un'eccezione.

System_CAPS_noteNota

È possibile utilizzare questo overload per connettersi a un contatore di sistema, ma non è possibile scrivere in un contatore di sistema. Pertanto, l'impostazione readOnly per false quando ci si connette a un contatore di sistema induce il costruttore generare un'eccezione.

System_CAPS_noteNota

Per leggere i contatori delle prestazioni in Windows Vista, Windows XP Professional x64 Edition o Windows Server 2003, è necessario essere un membro del gruppo Performance Monitor Users o disporre di privilegi amministrativi.

Per evitare la necessità di elevare i privilegi per accedere ai contatori delle prestazioni in Windows Vista, aggiungersi al gruppo Performance Monitor Users.

In Windows Vista, la funzionalità Controllo dell'account utente determina i privilegi di un utente. Ai membri del gruppo Administrators predefinito vengono assegnati due token di accesso in fase di esecuzione, ovvero un token di accesso utente standard e un token di accesso amministratore. Per impostazione predefinita, viene assegnato il ruolo dell'utente standard. Per eseguire il codice che accede ai contatori delle prestazioni, è innanzitutto necessario elevare i privilegi da utente standard ad amministratore. È possibile farlo quando si avvia un'applicazione facendo clic con il pulsante destro del mouse sull'icona dell'applicazione e indicando l'opzione di esecuzione come amministratore.

Esempio di codice seguente crea un'istanza di PerformanceCounter (classe). Nell'esempio viene passato in nomi di categoria, i nomi dei contatori e un valore di flag che indica che il contatore non è in sola lettura. Questo esempio di codice fa parte di un esempio più esteso per la PerformanceCounter classe.

avgCounter64Sample = new PerformanceCounter("AverageCounter64SampleCategory", 
    "AverageCounter64Sample", 
    false);

PerformanceCounterPermission

for reading the performance counter category if the P:System.Diagnostics.PerformanceCounter.ReadOnly property is true. Associated enumeration: F:System.Diagnostics.PerformanceCounterPermissionAccess.Read.

PerformanceCounterPermission

for writing the performance counter category if the P:System.Diagnostics.PerformanceCounter.ReadOnly property is false. Associated enumeration: F:System.Diagnostics.PerformanceCounterPermissionAccess.Write.

.NET Framework
Disponibile da 1.1
Torna all'inizio
Mostra: