PerformanceCounter Costruttori
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.
Inizializza una nuova istanza della classe PerformanceCounter.
PerformanceCounter() |
Consente di inizializzare una nuova istanza di sola lettura della classe PerformanceCounter, senza associare l'istanza a un contatore di sistema oppure a un contatore delle prestazioni personalizzato. |
PerformanceCounter(String, String) |
Consente di inizializzare una nuova istanza di sola lettura della classe PerformanceCounter e la associa al contatore di sistema specificato o al contatore delle prestazioni personalizzato sul computer locale. Il costruttore richiede che la categoria abbia una sola istanza. |
PerformanceCounter(String, String, Boolean) |
Consente di inizializzare una nuova istanza di sola lettura o di lettura e scrittura della classe PerformanceCounter e la associa al contatore di sistema specificato o al contatore delle prestazioni personalizzato sul computer locale. Il costruttore richiede che la categoria contenga una sola istanza. |
PerformanceCounter(String, String, String) |
Consente di inizializzare una nuova istanza di sola lettura della classe PerformanceCounter e la associa al contatore di sistema specificato o al contatore delle prestazioni personalizzato e all'istanza della categoria sul computer locale. |
PerformanceCounter(String, String, String, Boolean) |
Consente di inizializzare una nuova istanza di sola lettura o di lettura e scrittura della classe PerformanceCounter e la associa al contatore di sistema specificato o al contatore delle prestazioni personalizzato e all'istanza della categoria sul computer locale. |
PerformanceCounter(String, String, String, String) |
Consente di inizializzare una nuova istanza di sola lettura della classe PerformanceCounter e la associa al contatore di sistema specificato o al contatore delle prestazioni personalizzato e all'istanza della categoria sul computer specificato. |
- Origine:
- PerformanceCounter.cs
- Origine:
- PerformanceCounter.cs
- Origine:
- PerformanceCounter.cs
Consente di inizializzare una nuova istanza di sola lettura della classe PerformanceCounter, senza associare l'istanza a un contatore di sistema oppure a un contatore delle prestazioni personalizzato.
public:
PerformanceCounter();
public PerformanceCounter ();
Public Sub New ()
Esempio
Nell'esempio di codice seguente viene creata un'istanza predefinita della PerformanceCounter classe . Dopo aver creato l'istanza, vengono impostati i valori delle CategoryNameproprietà , CounterNamee InstanceName e i risultati di una chiamata al NextValue metodo vengono visualizzati.
PerformanceCounter^ PC = gcnew PerformanceCounter;
PC->CategoryName = "Process";
PC->CounterName = "Private Bytes";
PC->InstanceName = "Explorer";
MessageBox::Show( PC->NextValue().ToString() );
PerformanceCounter performanceCounter = new PerformanceCounter();
performanceCounter.CategoryName = "Process";
performanceCounter.CounterName = "Private Bytes";
performanceCounter.InstanceName = "Explorer";
MessageBox.Show(performanceCounter.NextValue().ToString());
Dim PC As New PerformanceCounter()
PC.CategoryName = "Process"
PC.CounterName = "Private Bytes"
PC.InstanceName = "Explorer"
MessageBox.Show(PC.NextValue().ToString())
Commenti
Questo overload del costruttore imposta le CategoryNameproprietà , CounterNamee InstanceName su stringhe vuote ("") e imposta la MachineName proprietà sul computer locale , (".").
Questo costruttore non inizializza il contatore delle prestazioni, pertanto non associa l'istanza a un contatore esistente nel computer locale. Per puntare a un contatore delle prestazioni specifico, impostare le CategoryNameproprietà , CounterNamee, facoltativamente, InstanceName e MachineName prima di leggere qualsiasi altra proprietà o tentare di leggere da un contatore. Per scrivere in un contatore delle prestazioni, impostare la ReadOnly proprietà su false
.
Nota
L'attributo HostProtectionAttribute applicato a questo membro ha il valore della proprietà seguenteResources: | SynchronizationSharedState . L'oggetto HostProtectionAttribute non influisce sulle applicazioni desktop, che in genere vengono avviate facendo doppio clic sull'icona, digitando un comando oppure immettendo un URL in un browser. Per altre informazioni, vedere la HostProtectionAttribute classe o gli attributi di programmazione e protezione host SQL Server.
Si applica a
.NET Framework 4.8.1 e altre versioni
Prodotto | Versioni |
---|---|
.NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
Windows Desktop | 3.0, 3.1, 5, 6, 7, 8, 9 |
- Origine:
- PerformanceCounter.cs
- Origine:
- PerformanceCounter.cs
- Origine:
- PerformanceCounter.cs
Consente di inizializzare una nuova istanza di sola lettura della classe PerformanceCounter e la associa al contatore di sistema specificato o al contatore delle prestazioni personalizzato sul computer locale. Il costruttore richiede che la categoria abbia una sola istanza.
public:
PerformanceCounter(System::String ^ categoryName, System::String ^ counterName);
public PerformanceCounter (string categoryName, string counterName);
new System.Diagnostics.PerformanceCounter : string * string -> System.Diagnostics.PerformanceCounter
Public Sub New (categoryName As String, counterName As String)
Parametri
- categoryName
- String
Nome della categoria del contatore delle prestazioni (oggetto prestazioni) alla quale è associato questo contatore delle prestazioni.
- counterName
- String
Nome del contatore di prestazioni.
Eccezioni
categoryName
è una stringa vuota ("").
-oppure-
counterName
è una stringa vuota ("").
-oppure-
La categoria specificata non esiste.
-oppure-
The category specified is marked as multi-instance and requires the performance counter to be created with an instance name (La categoria specificata è contrassegnata come categoria a più istanze ed è necessario che il contatore delle prestazioni venga creato con un nome di istanza).
-oppure-
categoryName
e counterName
sono stati localizzati in lingue diverse.
categoryName
o counterName
è null
.
Si è verificato un errore durante l'accesso a un'API di sistema.
Codice eseguito senza privilegi di amministratore ha tentato di leggere un contatore delle prestazioni.
Commenti
Le stringhe dei parametri non fanno distinzione tra maiuscole e minuscole.
Utilizzare questo overload per accedere a un contatore nel computer locale appartenente a una categoria contenente una singola istanza di categoria del contatore delle prestazioni. Se si tenta di usare questo costruttore per puntare questa PerformanceCounter istanza a una categoria che contiene più istanze, il costruttore genera un'eccezione. Questo overload può accedere a qualsiasi contatore di sola lettura o di lettura/scrittura, ma in modalità di sola lettura. Un'istanza PerformanceCounter creata con questo overload non può scrivere nel contatore, anche se il contatore stesso è di lettura/scrittura.
Questo overload del costruttore imposta le CategoryName proprietà e CounterName sui valori passati, imposta la MachineName proprietà sul 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 passati per le CategoryName proprietà e CounterName devono puntare a un contatore delle prestazioni esistente nel computer locale.
Nota
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 utenti di Monitor prestazioni 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 Monitor prestazioni.
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, è necessario innanzitutto elevare i privilegi dall'utente standard all'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.
Si applica a
.NET Framework 4.8.1 e altre versioni
Prodotto | Versioni |
---|---|
.NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
Windows Desktop | 3.0, 3.1, 5, 6, 7, 8, 9 |
- Origine:
- PerformanceCounter.cs
- Origine:
- PerformanceCounter.cs
- Origine:
- PerformanceCounter.cs
Consente di inizializzare una nuova istanza di sola lettura o di lettura e scrittura della classe PerformanceCounter e la associa al contatore di sistema specificato o al contatore delle prestazioni personalizzato sul computer locale. Il costruttore richiede che la categoria contenga una sola istanza.
public:
PerformanceCounter(System::String ^ categoryName, System::String ^ counterName, bool readOnly);
public PerformanceCounter (string categoryName, string counterName, bool readOnly);
new System.Diagnostics.PerformanceCounter : string * string * bool -> System.Diagnostics.PerformanceCounter
Public Sub New (categoryName As String, counterName As String, readOnly As Boolean)
Parametri
- categoryName
- String
Nome della categoria del contatore delle prestazioni (oggetto prestazioni) alla quale è associato questo contatore delle prestazioni.
- counterName
- String
Nome del contatore di prestazioni.
- readOnly
- Boolean
true
per accedere al contatore in modalità di sola lettura (sebbene il contatore stesso possa essere di lettura e scrittura); false
per accedere al contatore in modalità di lettura e scrittura.
Eccezioni
categoryName
è una stringa vuota ("").
-oppure-
counterName
è una stringa vuota ("").
-oppure-
La categoria specificata non esiste. (se readOnly
è true
).
-oppure-
La categoria specificata non è una categoria personalizzata .NET Framework (se readOnly
è false
).
-oppure-
The category specified is marked as multi-instance and requires the performance counter to be created with an instance name (La categoria specificata è contrassegnata come categoria a più istanze ed è necessario che il contatore delle prestazioni venga creato con un nome di istanza).
-oppure-
categoryName
e counterName
sono stati localizzati in lingue diverse.
categoryName
o counterName
è null
.
Si è verificato un errore durante l'accesso a un'API di sistema.
Codice eseguito senza privilegi di amministratore ha tentato di leggere un contatore delle prestazioni.
Esempio
Nell'esempio di codice seguente viene creata un'istanza della PerformanceCounter classe . Nell'esempio vengono passati nomi di categoria, nomi di contatori e un valore di flag che indica che il contatore non è di sola lettura. Questo esempio di codice fa parte di un esempio più ampio per la PerformanceCounter classe .
PC = gcnew PerformanceCounter( "AverageCounter64SampleCategory","AverageCounter64Sample",false );
avgCounter64Sample = new PerformanceCounter("AverageCounter64SampleCategory",
"AverageCounter64Sample",
false);
avgCounter64Sample = New PerformanceCounter("AverageCounter64SampleCategory", "AverageCounter64Sample", False)
Commenti
Le stringhe dei parametri non fanno distinzione tra maiuscole e minuscole.
Utilizzare questo overload per accedere a un contatore di sola lettura o di lettura/scrittura nel computer locale appartenente a una categoria contenente una singola istanza di categoria del contatore delle prestazioni. Se si tenta di usare questo costruttore per puntare questa PerformanceCounter istanza a una categoria che contiene più istanze, il costruttore genera un'eccezione.
Questo overload del costruttore imposta le CategoryNameproprietà , CounterNamee ReadOnly sui valori passati, imposta la MachineName proprietà sul 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 passati per le CategoryName proprietà e CounterName devono puntare a un contatore delle prestazioni esistente nel computer locale. Se l'istanza del contatore delle prestazioni a cui si fa riferimento non è valida, la chiamata al costruttore genera un'eccezione.
Nota
È possibile utilizzare questo overload per connettersi a un contatore di sistema, ma non è possibile scrivere in un contatore di sistema. Pertanto, l'impostazione su readOnly
false
quando ci si connette a un contatore di sistema fa sì che il costruttore generi un'eccezione.
Nota
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 utenti di Monitor prestazioni 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 Monitor prestazioni.
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, è necessario innanzitutto elevare i privilegi dall'utente standard all'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.
Si applica a
.NET Framework 4.8.1 e altre versioni
Prodotto | Versioni |
---|---|
.NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
Windows Desktop | 3.0, 3.1, 5, 6, 7, 8, 9 |
- Origine:
- PerformanceCounter.cs
- Origine:
- PerformanceCounter.cs
- Origine:
- PerformanceCounter.cs
Consente di inizializzare una nuova istanza di sola lettura della classe PerformanceCounter e la associa al contatore di sistema specificato o al contatore delle prestazioni personalizzato e all'istanza della categoria sul computer locale.
public:
PerformanceCounter(System::String ^ categoryName, System::String ^ counterName, System::String ^ instanceName);
public PerformanceCounter (string categoryName, string counterName, string instanceName);
new System.Diagnostics.PerformanceCounter : string * string * string -> System.Diagnostics.PerformanceCounter
Public Sub New (categoryName As String, counterName As String, instanceName As String)
Parametri
- categoryName
- String
Nome della categoria del contatore delle prestazioni (oggetto prestazioni) alla quale è associato questo contatore delle prestazioni.
- counterName
- String
Nome del contatore di prestazioni.
- instanceName
- String
Il nome dell'istanza della categoria del contatore delle prestazioni, oppure una stringa vuota ("") se la categoria contiene una sola istanza.
Eccezioni
categoryName
è una stringa vuota ("").
-oppure-
counterName
è una stringa vuota ("").
-oppure-
La categoria specificata non è valida.
-oppure-
The category specified is marked as multi-instance and requires the performance counter to be created with an instance name (La categoria specificata è contrassegnata come categoria a più istanze ed è necessario che il contatore delle prestazioni venga creato con un nome di istanza).
-oppure-
instanceName
è di lunghezza superiore a 127 caratteri.
-oppure-
categoryName
e counterName
sono stati localizzati in lingue diverse.
categoryName
o counterName
è null
.
Si è verificato un errore durante l'accesso a un'API di sistema.
Codice eseguito senza privilegi di amministratore ha tentato di leggere un contatore delle prestazioni.
Commenti
Le stringhe dei parametri non fanno distinzione tra maiuscole e minuscole.
Questo overload del costruttore imposta le CategoryNameproprietà , CounterNamee InstanceName sui valori passati e imposta la MachineName proprietà sul computer locale".
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 passati per le CategoryNameproprietà , CounterNamee InstanceName devono puntare a un contatore delle prestazioni esistente nel computer locale. Se l'istanza del contatore delle prestazioni a cui si punta non è valida, la chiamata al costruttore genera un'eccezione.
Questo overload può accedere a qualsiasi contatore di sola lettura o di lettura/scrittura, ma in modalità di sola lettura. Un'istanza PerformanceCounter creata con questo overload non può scrivere nel contatore, anche se il contatore stesso è di lettura/scrittura.
Per creare un'istanza della categoria di prestazioni, specificare un instanceName
oggetto nel PerformanceCounter costruttore . Se l'istanza di categoria specificata da instanceName
esiste già, il nuovo oggetto farà riferimento all'istanza di categoria esistente.
Nota
Per leggere i contatori delle prestazioni in Windows Vista, Windows XP Professional x64 Edition o Windows Server 2003, è necessario essere membri del gruppo utenti di Monitor prestazioni 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 Monitor prestazioni.
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, è necessario innanzitutto elevare i privilegi dall'utente standard all'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.
Si applica a
.NET Framework 4.8.1 e altre versioni
Prodotto | Versioni |
---|---|
.NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
Windows Desktop | 3.0, 3.1, 5, 6, 7, 8, 9 |
- Origine:
- PerformanceCounter.cs
- Origine:
- PerformanceCounter.cs
- Origine:
- PerformanceCounter.cs
Consente di inizializzare una nuova istanza di sola lettura o di lettura e scrittura della classe PerformanceCounter e la associa al contatore di sistema specificato o al contatore delle prestazioni personalizzato e all'istanza della categoria sul computer locale.
public:
PerformanceCounter(System::String ^ categoryName, System::String ^ counterName, System::String ^ instanceName, bool readOnly);
public PerformanceCounter (string categoryName, string counterName, string instanceName, bool readOnly);
new System.Diagnostics.PerformanceCounter : string * string * string * bool -> System.Diagnostics.PerformanceCounter
Public Sub New (categoryName As String, counterName As String, instanceName As String, readOnly As Boolean)
Parametri
- categoryName
- String
Nome della categoria del contatore delle prestazioni (oggetto prestazioni) alla quale è associato questo contatore delle prestazioni.
- counterName
- String
Nome del contatore di prestazioni.
- instanceName
- String
Il nome dell'istanza della categoria del contatore delle prestazioni, oppure una stringa vuota ("") se la categoria contiene una sola istanza.
- readOnly
- Boolean
true
per accedere a un contatore in modalità di sola lettura; false
per accedere a un contatore in modalità di lettura e scrittura.
Eccezioni
categoryName
è una stringa vuota ("").
-oppure-
counterName
è una stringa vuota ("").
-oppure-
The read/write permission setting requested is invalid for this counter (L'impostazione dell'autorizzazione di lettura/scrittura richiesta non è valida per questo contatore).
-oppure-
La categoria specificata non esiste (se readOnly
è true
).
-oppure-
La categoria specificata non è una categoria personalizzata .NET Framework (se readOnly
è false
).
-oppure-
The category specified is marked as multi-instance and requires the performance counter to be created with an instance name (La categoria specificata è contrassegnata come categoria a più istanze ed è necessario che il contatore delle prestazioni venga creato con un nome di istanza).
-oppure-
instanceName
è di lunghezza superiore a 127 caratteri.
-oppure-
categoryName
e counterName
sono stati localizzati in lingue diverse.
categoryName
o counterName
è null
.
Si è verificato un errore durante l'accesso a un'API di sistema.
Codice eseguito senza privilegi di amministratore ha tentato di leggere un contatore delle prestazioni.
Commenti
Le stringhe dei parametri non fanno distinzione tra maiuscole e minuscole.
Usare questo overload per accedere a un contatore delle prestazioni in modalità di sola lettura o di lettura/scrittura.
Questo overload del costruttore imposta le CategoryNameproprietà , CounterNamee InstanceName sui valori passati e imposta la MachineName proprietà sul computer locale".
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 passati per le CategoryNameproprietà , CounterNamee InstanceName devono puntare a un contatore delle prestazioni esistente nel computer locale. Se l'istanza del contatore delle prestazioni a cui si fa riferimento non è valida, la chiamata al costruttore genera un'eccezione.
Nota
È possibile utilizzare questo overload per connettersi a un contatore di sistema, ma non è possibile scrivere in un contatore di sistema. Pertanto, l'impostazione su readOnly
false
quando ci si connette a un contatore di sistema fa sì che il costruttore generi un'eccezione.
Per creare un'istanza della categoria di prestazioni, specificare un instanceName
oggetto nel PerformanceCounter costruttore . Se l'istanza di categoria specificata da instanceName
esiste già, il nuovo oggetto farà riferimento all'istanza di categoria esistente.
Nota
Per leggere i contatori delle prestazioni in Windows Vista, Windows XP Professional x64 Edition o Windows Server 2003, è necessario essere membri del gruppo utenti di Monitor prestazioni 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 Monitor prestazioni.
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, è necessario innanzitutto elevare i privilegi dall'utente standard all'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.
Si applica a
.NET Framework 4.8.1 e altre versioni
Prodotto | Versioni |
---|---|
.NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
Windows Desktop | 3.0, 3.1, 5, 6, 7, 8, 9 |
- Origine:
- PerformanceCounter.cs
- Origine:
- PerformanceCounter.cs
- Origine:
- PerformanceCounter.cs
Consente di inizializzare una nuova istanza di sola lettura della classe PerformanceCounter e la associa al contatore di sistema specificato o al contatore delle prestazioni personalizzato e all'istanza della categoria sul computer specificato.
public:
PerformanceCounter(System::String ^ categoryName, System::String ^ counterName, System::String ^ instanceName, System::String ^ machineName);
public PerformanceCounter (string categoryName, string counterName, string instanceName, string machineName);
new System.Diagnostics.PerformanceCounter : string * string * string * string -> System.Diagnostics.PerformanceCounter
Public Sub New (categoryName As String, counterName As String, instanceName As String, machineName As String)
Parametri
- categoryName
- String
Nome della categoria del contatore delle prestazioni (oggetto prestazioni) alla quale è associato questo contatore delle prestazioni.
- counterName
- String
Nome del contatore di prestazioni.
- instanceName
- String
Il nome dell'istanza della categoria del contatore delle prestazioni, oppure una stringa vuota ("") se la categoria contiene una sola istanza.
- machineName
- String
Il computer sul quale sono presenti il contatore delle prestazioni e la categoria associata.
Eccezioni
categoryName
è una stringa vuota ("").
-oppure-
counterName
è una stringa vuota ("").
-oppure-
The read/write permission setting requested is invalid for this counter (L'impostazione dell'autorizzazione di lettura/scrittura richiesta non è valida per questo contatore).
-oppure-
Il contatore non è presente sul computer specificato.
-oppure-
The category specified is marked as multi-instance and requires the performance counter to be created with an instance name (La categoria specificata è contrassegnata come categoria a più istanze ed è necessario che il contatore delle prestazioni venga creato con un nome di istanza).
-oppure-
instanceName
è di lunghezza superiore a 127 caratteri.
-oppure-
categoryName
e counterName
sono stati localizzati in lingue diverse.
Il parametro machineName
non è valido.
categoryName
o counterName
è null
.
Si è verificato un errore durante l'accesso a un'API di sistema.
Codice eseguito senza privilegi di amministratore ha tentato di leggere un contatore delle prestazioni.
Commenti
Le stringhe dei parametri non fanno distinzione tra maiuscole e minuscole.
Questo overload del costruttore imposta le CategoryNameproprietà , CounterName, InstanceNamee MachineName sui valori passati.
Questo costruttore inizializza il contatore delle prestazioni e associa l'istanza a un contatore esistente (un sistema o un contatore personalizzato) nel computer specificato. I valori passati per le CategoryNameproprietà , CounterNameInstanceName e MachineName devono puntare a un contatore delle prestazioni esistente. Se l'istanza del contatore delle prestazioni a cui si punta non è valida, la chiamata al costruttore genera un'eccezione. Questo overload può accedere a qualsiasi contatore di sola lettura o di lettura/scrittura, ma in modalità di sola lettura. Un'istanza PerformanceCounter creata con questo overload non può scrivere nel contatore, anche se il contatore stesso è di lettura/scrittura.
Nota
Non è possibile scrivere nei contatori delle prestazioni remoti. Non esiste alcun overload che consente di specificare un'istanza di lettura/scrittura della PerformanceCounter classe che si connette a un computer remoto.
Per creare un'istanza della categoria di prestazioni, specificare un instanceName
oggetto nel PerformanceCounter costruttore . Se l'istanza di categoria specificata da instanceName
esiste già, il nuovo oggetto farà riferimento all'istanza di categoria esistente.
Nota
Per leggere i contatori delle prestazioni in Windows Vista, Windows XP Professional x64 Edition o Windows Server 2003, è necessario essere membri del gruppo utenti di Monitor prestazioni 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 Monitor prestazioni.
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, è necessario innanzitutto elevare i privilegi dall'utente standard all'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.
Nota
In Windows Vista, quando il computer remoto è membro di un gruppo di lavoro, potrebbe essere necessario disabilitare Controllo dell'account utente in modo che l'account utente locale non venga filtrato e possa essere elevato a un account amministratore. Per motivi di sicurezza, la disabilitazione di Controllo dell'account utente deve essere un'ultima risorsa. Per informazioni sulla disabilitazione di Controllo dell'account utente, vedere Controllo dell'account utente e WMI.
Si applica a
.NET Framework 4.8.1 e altre versioni
Prodotto | Versioni |
---|---|
.NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
Windows Desktop | 3.0, 3.1, 5, 6, 7, 8, 9 |
Feedback su .NET
.NET è un progetto di open source. Selezionare un collegamento per fornire feedback: