CounterSet.CreateCounterSetInstance(String) Metoda

Definicja

Przestrzeń nazw:

System.Diagnostics.PerformanceData

Zestaw:

System.Diagnostics.PerformanceCounter.dll

Pakiet:

System.Diagnostics.PerformanceCounter v8.0.0

Źródło:

CounterSet.cs

Tworzy wystąpienie zestawu liczników.

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

Parametry

instanceName

String

Nazwa wystąpienia. Nazwa musi być unikatowa.

Zwraca

CounterSetInstance

Wystąpienie zestawu liczników, które będzie zawierać dane licznika.

Wyjątki

ArgumentException

Nazwa wystąpienia ma wartość NULL.

InvalidOperationException

Przed utworzeniem wystąpienia zestawu liczników należy dodać liczniki.

Przykłady

Aby zapoznać się z przykładem, zobacz System.Diagnostics.PerformanceData.

Uwagi

Wywołaj tę metodę jednorazowo dla zestawów liczników pojedynczego wystąpienia i co najmniej jeden raz dla zestawów liczników wielu wystąpień.

Dostawca określa, kiedy tworzy wystąpienie. Jeśli dane licznika są bardziej statyczne, dostawca może utworzyć wystąpienie w czasie inicjowania. Na przykład liczba procesorów na komputerze byłaby uznawana za statyczną, więc dostawca, który dostarcza dane licznika dla procesorów, może utworzyć wystąpienie dla każdego procesora na komputerze w czasie inicjowania. W przypadku liczników bardziej dynamicznych, takich jak liczniki dysku lub procesu, dostawcy utworzyliby nowe wystąpienia w odpowiedzi na dodanie nowego urządzenia USB lub utworzenie nowego procesu.

Dostawca powinien przechowywać aktualne dane licznika przez cały czas.