Freigeben über


CounterSet.CreateCounterSetInstance(String) Methode

Definition

Erstellt eine Instanz des Indikatorensatzes.

public:
 System::Diagnostics::PerformanceData::CounterSetInstance ^ CreateCounterSetInstance(System::String ^ instanceName);
public System.Diagnostics.PerformanceData.CounterSetInstance CreateCounterSetInstance (string instanceName);
[System.Security.SecurityCritical]
public System.Diagnostics.PerformanceData.CounterSetInstance CreateCounterSetInstance (string instanceName);
member this.CreateCounterSetInstance : string -> System.Diagnostics.PerformanceData.CounterSetInstance
[<System.Security.SecurityCritical>]
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

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

Attribute

Ausnahmen

Der Instanzname ist NULL.

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.

Gilt für: