CounterSet.CreateCounterSetInstance(String) Metodo

Definizione

Spazio dei nomi:

System.Diagnostics.PerformanceData

Assembly:

System.Diagnostics.PerformanceCounter.dll

Pacchetto:

System.Diagnostics.PerformanceCounter v8.0.0

Origine:

CounterSet.cs

Crea un'istanza dell'insieme di contatori.

public:
 System::Diagnostics::PerformanceData::CounterSetInstance ^ CreateCounterSetInstance(System::String ^ instanceName);

public System.Diagnostics.PerformanceData.CounterSetInstance CreateCounterSetInstance (string instanceName);

member this.CreateCounterSetInstance : string -> System.Diagnostics.PerformanceData.CounterSetInstance

Public Function CreateCounterSetInstance (instanceName As String) As CounterSetInstance

Parametri

instanceName

String

Nome dell’istanza. Il nome deve essere univoco.

Restituisce

CounterSetInstance

Un'istanza dell'insieme di contatori che contiene i dati dei contatori.

Eccezioni

ArgumentException

Il nome dell'istanza è NULL.

InvalidOperationException

È necessario aggiungere i contatori all'insieme prima di creare un'istanza dell'insieme di contatori.

Esempio

Per un esempio, vedere System.Diagnostics.PerformanceData.

Commenti

Chiamare questo metodo una volta per i set di contatori a istanza singola e una o più volte per i set di contatori a più istanze.

Il provider determina quando crea un'istanza. Se i dati del contatore sono più statici, il provider può creare un'istanza in fase di inizializzazione. Ad esempio, il numero di processori in un computer verrebbe considerato statico, quindi un provider che fornisce dati contatori per i responsabili del trattamento potrebbe creare un'istanza per ogni processore nel computer in fase di inizializzazione. Per i contatori più dinamici, ad esempio i contatori del disco o del processo, i provider creerebbero le nuove istanze in risposta all'aggiunta di un nuovo dispositivo USB o alla creazione di un nuovo processo.

Il provider deve mantenere sempre aggiornati i dati del contatore.