CounterSet.CreateCounterSetInstance(String) Methode

Definition

Namespace:

System.Diagnostics.PerformanceData

Assembly:

System.Diagnostics.PerformanceCounter.dll

Paket:

System.Diagnostics.PerformanceCounter v8.0.0

Quelle:

CounterSet.cs

Erstellt eine Instanz des Indikatorensatzes.

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

Parameter

instanceName

String

Der Name der Instanz. Der Name muss eindeutig sein.

Gibt zurück

CounterSetInstance

Eine Instanz des Indikatorensatzes, die die Indikatordaten enthält.

Ausnahmen

ArgumentException

Der Instanzname ist NULL.

InvalidOperationException

Sie müssen dem Indikatorensatz Indikatoren hinzufügen, bevor Sie eine Instanz des Indikatorensatzes erstellen.

Beispiele

Ein Beispiel finden Sie unter System.Diagnostics.PerformanceData.

Hinweise

Rufen Sie diese Methode einmal für einzelne instance-Zählersätze und ein oder mehrere Male für indikatorensätze mit mehreren instance auf.

Der Anbieter bestimmt, wann er eine instance erstellt. Wenn die Zählerdaten statischer sind, kann der Anbieter zum Zeitpunkt der Initialisierung eine instance erstellen. Beispielsweise würde die Anzahl der Prozessoren auf einem Computer als statisch angesehen, sodass ein Anbieter, der Zählerdaten für Prozessoren bereitstellt, zur Initialisierungszeit eine instance für jeden Prozessor auf dem Computer erstellen könnte. Bei Leistungsindikatoren, die dynamischer sind, z. B. Datenträger- oder Prozessindikatoren, würden die Anbieter die neuen Instanzen als Reaktion darauf erstellen, dass ein neues USB-Gerät hinzugefügt oder ein neuer Prozess erstellt wird.

Der Anbieter sollte die Zählerdaten jederzeit auf dem neuesten Stand halten.