CounterSet.CreateCounterSetInstance(String) Metoda

Definice

Obor názvů:

System.Diagnostics.PerformanceData

Sestavení:

System.Diagnostics.PerformanceCounter.dll

Balíček:

System.Diagnostics.PerformanceCounter v11.0.0-preview.5.26302.115

Zdroj:

CounterSet.cs

Vytvoří instanci sady čítačů.

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

Název instance. Název musí být jedinečný.

Návraty

CounterSetInstance

Instance sady čítačů, která bude obsahovat data čítače.

Výjimky

ArgumentException

Název instance má hodnotu NULL.

InvalidOperationException

Před vytvořením instance sady čítačů je nutné do sady čítačů přidat čítače.

Příklady

Pro příklad viz System.Diagnostics.PerformanceData.

Poznámky

Tuto metodu jednou zavolejte pro sady čítačů s jednou instancí a jednou nebo vícekrát pro sady čítačů s více instancemi.

Poskytovatel určí, kdy vytvoří instanci. Pokud jsou data čítače statická, může zprostředkovatel vytvořit instanci v době inicializace. Například počet procesorů v počítači by byl považován za statický, takže poskytovatel, který poskytuje data čítačů pro procesory, by mohl vytvořit instanci pro každý procesor v počítači v době inicializace. U čítačů, které jsou dynamičtější, jako jsou čítače disku nebo procesu, by poskytovatelé vytvořili nové instance v reakci na přidání nového zařízení USB nebo vytvoření nového procesu.

Zprostředkovatel by měl uchovávat data čítačů up-to-datem vždy.