CounterSet.CreateCounterSetInstance(String) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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.CounterSetInstancePublic Function CreateCounterSetInstance (instanceName As String) As CounterSetInstanceParameter
- 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.
