PerformanceCounterCategory.Create Metoda

Definice

Obor názvů:

System.Diagnostics

Sestavení:

System.Diagnostics.PerformanceCounter.dll

Balíček:

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

Zaregistruje vlastní kategorii čítače výkonu a jeden nebo více čítačů v systému.

Přetížení

Name	Description
Create(String, String, String, String)	Zastaralé. Zaregistruje vlastní kategorii čítače výkonu obsahující jeden čítač typu NumberOfItems32 v místním počítači.
Create(String, String, PerformanceCounterCategoryType, String, String)	Zaregistruje vlastní kategorii čítače výkonu obsahující jeden čítač typu NumberOfItems32 v místním počítači.
Create(String, String, CounterCreationDataCollection)	Zastaralé. Zaregistruje vlastní kategorii čítače výkonu obsahující zadané čítače v místním počítači.
Create(String, String, PerformanceCounterCategoryType, CounterCreationDataCollection)	Zaregistruje vlastní kategorii čítače výkonu obsahující zadané čítače v místním počítači.

Create(String, String, String, String)

Zdroj:

PerformanceCounterCategory.cs

Upozornění

This overload of PerformanceCounterCategory.Create has been deprecated. Use System.Diagnostics.PerformanceCounterCategory.Create(string categoryName, string categoryHelp, PerformanceCounterCategoryType categoryType, string counterName, string counterHelp) instead.

Zaregistruje vlastní kategorii čítače výkonu obsahující jeden čítač typu NumberOfItems32 v místním počítači.

public:
 static System::Diagnostics::PerformanceCounterCategory ^ Create(System::String ^ categoryName, System::String ^ categoryHelp, System::String ^ counterName, System::String ^ counterHelp);

[System.Obsolete("This overload of PerformanceCounterCategory.Create has been deprecated. Use System.Diagnostics.PerformanceCounterCategory.Create(string categoryName, string categoryHelp, PerformanceCounterCategoryType categoryType, string counterName, string counterHelp) instead.")]
public static System.Diagnostics.PerformanceCounterCategory Create(string categoryName, string categoryHelp, string counterName, string counterHelp);

[<System.Obsolete("This overload of PerformanceCounterCategory.Create has been deprecated. Use System.Diagnostics.PerformanceCounterCategory.Create(string categoryName, string categoryHelp, PerformanceCounterCategoryType categoryType, string counterName, string counterHelp) instead.")>]
static member Create : string * string * string * string -> System.Diagnostics.PerformanceCounterCategory

Public Shared Function Create (categoryName As String, categoryHelp As String, counterName As String, counterHelp As String) As PerformanceCounterCategory

Parametry

categoryName

String

Název vlastní kategorie čítače výkonu pro vytvoření a registraci v systému.

categoryHelp

String

Popis vlastní kategorie

counterName

String

Název nového čítače typu NumberOfItems32, který se má vytvořit jako součást nové kategorie.

counterHelp

String

Popis čítače, který je přidružený k nové vlastní kategorii.

Návraty

PerformanceCounterCategory

Objekt PerformanceCounterCategory , který je přidružený k nové systémové kategorii nebo objektu výkonu.

Atributy

ObsoleteAttribute

Výjimky

ArgumentException

counterName je null nebo je prázdný řetězec ("").

nebo

Čítač určený counterName již existuje.

nebo

counterName má neplatnou syntaxi. Může obsahovat znaky zpětného lomítka (\) nebo delší než 80 znaků.

InvalidOperationException

Kategorie již v místním počítači existuje.

ArgumentNullException

categoryName je null.

nebo

counterHelp je null.

Win32Exception

Volání základního systémového rozhraní API selhalo.

UnauthorizedAccessException

Kód, který se spouští bez oprávnění správce, se pokusil přečíst čítač výkonu.

Poznámky

Note

Chcete-li číst čítače výkonu z neinteraktivní přihlašovací relace v systémech Windows Vista a novějších, Windows XP Professional x64 Edition nebo Windows Server 2003, musíte být členem skupiny Uživatelé sledování výkonu nebo mít oprávnění správce.

Abyste se vyhnuli zvýšení oprávnění pro přístup k čítačům výkonu v systému Windows Vista a novějším, přidejte se do skupiny Uživatelé sledování výkonu.

V systému Windows Vista a novějších určuje řízení uživatelských účtů (UAC) oprávnění uživatele. Pokud jste členem předdefinované skupiny Administrators, máte přiřazené dva přístupové tokeny za běhu: standardní přístupový token uživatele a přístupový token správce. Ve výchozím nastavení jste ve standardní roli uživatele. Pokud chcete spustit kód, který přistupuje k čítačům výkonu, musíte nejprve zvýšit oprávnění od standardního uživatele na správce. Můžete to udělat, když spustíte aplikaci tak, že kliknete pravým tlačítkem myši na ikonu aplikace a označíte, že chcete spustit jako správce.

Viz také

• Delete(String)
• Exists(String)
• PerformanceCounter
• CounterHelp

Create(String, String, PerformanceCounterCategoryType, String, String)

Zdroj:

PerformanceCounterCategory.cs

Zaregistruje vlastní kategorii čítače výkonu obsahující jeden čítač typu NumberOfItems32 v místním počítači.

public:
 static System::Diagnostics::PerformanceCounterCategory ^ Create(System::String ^ categoryName, System::String ^ categoryHelp, System::Diagnostics::PerformanceCounterCategoryType categoryType, System::String ^ counterName, System::String ^ counterHelp);

public static System.Diagnostics.PerformanceCounterCategory Create(string categoryName, string categoryHelp, System.Diagnostics.PerformanceCounterCategoryType categoryType, string counterName, string counterHelp);

static member Create : string * string * System.Diagnostics.PerformanceCounterCategoryType * string * string -> System.Diagnostics.PerformanceCounterCategory

Public Shared Function Create (categoryName As String, categoryHelp As String, categoryType As PerformanceCounterCategoryType, counterName As String, counterHelp As String) As PerformanceCounterCategory

Parametry

categoryName

String

Název vlastní kategorie čítače výkonu pro vytvoření a registraci v systému.

categoryHelp

String

Popis vlastní kategorie

categoryType

PerformanceCounterCategoryType

Jedna z PerformanceCounterCategoryType hodnot určující, zda je MultiInstancekategorie , SingleInstancenebo Unknown.

counterName

String

Název nového čítače, který se má vytvořit jako součást nové kategorie.

counterHelp

String

Popis čítače, který je přidružený k nové vlastní kategorii.

Návraty

PerformanceCounterCategory

Objekt PerformanceCounterCategory , který je přidružený k nové systémové kategorii nebo objektu výkonu.

Výjimky

ArgumentException

counterName je null nebo je prázdný řetězec ("").

nebo

Čítač určený counterName již existuje.

nebo

counterName má neplatnou syntaxi. Může obsahovat znaky zpětného lomítka (\) nebo delší než 80 znaků.

InvalidOperationException

Kategorie již v místním počítači existuje.

ArgumentNullException

categoryName je null.

nebo

counterHelp je null.

Win32Exception

Volání základního systémového rozhraní API selhalo.

UnauthorizedAccessException

Kód, který se spouští bez oprávnění správce, se pokusil přečíst čítač výkonu.

Příklady

Následující příklad kódu ukazuje použití Create metody. Příklad ukazuje, jak vytvořit vlastní kategorii čítače výkonu jedné instance.

Console.WriteLine("Creating Inventory custom counter");
if (!PerformanceCounterCategory.Exists("Inventory"))
    PerformanceCounterCategory.Create("Inventory",
        "Truck inventory",
        PerformanceCounterCategoryType.SingleInstance,
        "Trucks", "Number of trucks on hand");

Console.WriteLine("Creating Inventory custom counter")
If Not PerformanceCounterCategory.Exists("Inventory") Then
    PerformanceCounterCategory.Create("Inventory", "Truck inventory", PerformanceCounterCategoryType.SingleInstance, "Trucks", "Number of trucks on hand")
End If

Poznámky

Parametr categoryType určuje, jestli je kategorie čítače výkonu jedna instance nebo více instancí. Ve výchozím nastavení je kategorie při vytváření jedna instance a při přidání jiné instance se stane více instancemi. Kategorie se vytvoří při nastavování aplikace a instance se přidají za běhu. Výčet PerformanceCounterCategoryType se používá k označení, zda může mít čítač výkonu více instancí.

Kategorie čítačů výkonu nainstalované s .NET používají samostatnou sdílenou paměť, přičemž každá kategorie čítače výkonu má vlastní paměť. Velikost samostatné sdílené paměti můžete určit vytvořením DWORD s názvem FileMappingSize v klíči registru HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\<název> kategorie\Výkon. Hodnota FileMappingSize je nastavena na velikost sdílené paměti kategorie. Výchozí velikost je 131072 desetinných míst. Pokud hodnota FileMappingSize není k dispozici, fileMappingSize použije se hodnota atributu performanceCounters pro prvek zadaný v souboru Machine.config, což způsobuje další režii při zpracování konfiguračního souboru. Zlepšení výkonu při spuštění aplikace můžete zjistit nastavením velikosti mapování souborů v registru.

Note

Důrazně doporučujeme vytvořit nové kategorie čítačů výkonu během instalace aplikace, ne během provádění aplikace. Díky tomu může operační systém aktualizovat seznam registrovaných kategorií čítačů výkonu. Pokud se seznam neaktualizoval, pokus o použití kategorie selže.

Note

Chcete-li číst čítače výkonu z neinteraktivní přihlašovací relace v systémech Windows Vista a novějších, Windows XP Professional x64 Edition nebo Windows Server 2003, musíte být členem skupiny Uživatelé sledování výkonu nebo mít oprávnění správce.

Abyste se vyhnuli zvýšení oprávnění pro přístup k čítačům výkonu v systému Windows Vista a novějším, přidejte se do skupiny Uživatelé sledování výkonu.

V systému Windows Vista a novějších určuje řízení uživatelských účtů (UAC) oprávnění uživatele. Pokud jste členem předdefinované skupiny Administrators, máte přiřazené dva přístupové tokeny za běhu: standardní přístupový token uživatele a přístupový token správce. Ve výchozím nastavení jste ve standardní roli uživatele. Pokud chcete spustit kód, který přistupuje k čítačům výkonu, musíte nejprve zvýšit oprávnění od standardního uživatele na správce. Můžete to udělat, když spustíte aplikaci tak, že kliknete pravým tlačítkem myši na ikonu aplikace a označíte, že chcete spustit jako správce.

Viz také

• Delete(String)
• Exists(String)
• PerformanceCounter
• CounterCreationDataCollection

Create(String, String, CounterCreationDataCollection)

Zdroj:

PerformanceCounterCategory.cs

Upozornění

This overload of PerformanceCounterCategory.Create has been deprecated. Use System.Diagnostics.PerformanceCounterCategory.Create(string categoryName, string categoryHelp, PerformanceCounterCategoryType categoryType, CounterCreationDataCollection counterData) instead.

Zaregistruje vlastní kategorii čítače výkonu obsahující zadané čítače v místním počítači.

public:
 static System::Diagnostics::PerformanceCounterCategory ^ Create(System::String ^ categoryName, System::String ^ categoryHelp, System::Diagnostics::CounterCreationDataCollection ^ counterData);

[System.Obsolete("This overload of PerformanceCounterCategory.Create has been deprecated. Use System.Diagnostics.PerformanceCounterCategory.Create(string categoryName, string categoryHelp, PerformanceCounterCategoryType categoryType, CounterCreationDataCollection counterData) instead.")]
public static System.Diagnostics.PerformanceCounterCategory Create(string categoryName, string categoryHelp, System.Diagnostics.CounterCreationDataCollection counterData);

[<System.Obsolete("This overload of PerformanceCounterCategory.Create has been deprecated. Use System.Diagnostics.PerformanceCounterCategory.Create(string categoryName, string categoryHelp, PerformanceCounterCategoryType categoryType, CounterCreationDataCollection counterData) instead.")>]
static member Create : string * string * System.Diagnostics.CounterCreationDataCollection -> System.Diagnostics.PerformanceCounterCategory

Public Shared Function Create (categoryName As String, categoryHelp As String, counterData As CounterCreationDataCollection) As PerformanceCounterCategory

Parametry

categoryName

String

Název vlastní kategorie čítače výkonu pro vytvoření a registraci v systému.

categoryHelp

String

Popis vlastní kategorie

counterData

CounterCreationDataCollection

A CounterCreationDataCollection , který určuje čítače, které se mají vytvořit jako součást nové kategorie.

Návraty

PerformanceCounterCategory

Objekt PerformanceCounterCategory , který je přidružený k nové vlastní kategorii nebo objektu výkonu.

Atributy

ObsoleteAttribute

Výjimky

ArgumentException

Název čítače zadaný v kolekci counterData je null nebo prázdný řetězec ("").

nebo

Čítač zadaný v rámci counterData kolekce již existuje.

ArgumentNullException

Parametr categoryName je null.

InvalidOperationException

Kategorie již v místním počítači existuje.

nebo

Rozložení counterData kolekce není pro základní čítače správné. Čítač typu AverageCount64, AverageTimer32, CounterMultiTimerCounterMultiTimerInverseCounterMultiTimer100NsCounterMultiTimer100NsInverse, RawFractionSampleFractionnebo SampleCounter musí být bezprostředně následovaný jedním ze základních typů čítačů (AverageBase, MultiBase, RawBase, nebo ).SampleBase

Win32Exception

Volání základního systémového rozhraní API selhalo.

UnauthorizedAccessException

Kód, který se spouští bez oprávnění správce, se pokusil přečíst čítač výkonu.

Poznámky

Note

Chcete-li číst čítače výkonu z neinteraktivní přihlašovací relace v systémech Windows Vista a novějších, Windows XP Professional x64 Edition nebo Windows Server 2003, musíte být členem skupiny Uživatelé sledování výkonu nebo mít oprávnění správce.

Abyste se vyhnuli zvýšení oprávnění pro přístup k čítačům výkonu v systému Windows Vista a novějším, přidejte se do skupiny Uživatelé sledování výkonu.

V systému Windows Vista a novějších určuje řízení uživatelských účtů (UAC) oprávnění uživatele. Pokud jste členem předdefinované skupiny Administrators, máte přiřazené dva přístupové tokeny za běhu: standardní přístupový token uživatele a přístupový token správce. Ve výchozím nastavení jste ve standardní roli uživatele. Pokud chcete spustit kód, který přistupuje k čítačům výkonu, musíte nejprve zvýšit oprávnění od standardního uživatele na správce. Můžete to udělat, když spustíte aplikaci tak, že kliknete pravým tlačítkem myši na ikonu aplikace a označíte, že chcete spustit jako správce.

Viz také

• Delete(String)
• Exists(String)
• PerformanceCounter
• CounterCreationDataCollection

Create(String, String, PerformanceCounterCategoryType, CounterCreationDataCollection)

Zdroj:

PerformanceCounterCategory.cs

Zaregistruje vlastní kategorii čítače výkonu obsahující zadané čítače v místním počítači.

public:
 static System::Diagnostics::PerformanceCounterCategory ^ Create(System::String ^ categoryName, System::String ^ categoryHelp, System::Diagnostics::PerformanceCounterCategoryType categoryType, System::Diagnostics::CounterCreationDataCollection ^ counterData);

public static System.Diagnostics.PerformanceCounterCategory Create(string categoryName, string categoryHelp, System.Diagnostics.PerformanceCounterCategoryType categoryType, System.Diagnostics.CounterCreationDataCollection counterData);

static member Create : string * string * System.Diagnostics.PerformanceCounterCategoryType * System.Diagnostics.CounterCreationDataCollection -> System.Diagnostics.PerformanceCounterCategory

Public Shared Function Create (categoryName As String, categoryHelp As String, categoryType As PerformanceCounterCategoryType, counterData As CounterCreationDataCollection) As PerformanceCounterCategory

Parametry

categoryName

String

Název vlastní kategorie čítače výkonu pro vytvoření a registraci v systému.

categoryHelp

String

Popis vlastní kategorie

categoryType

PerformanceCounterCategoryType

Jedna z PerformanceCounterCategoryType hodnot.

counterData

CounterCreationDataCollection

A CounterCreationDataCollection , který určuje čítače, které se mají vytvořit jako součást nové kategorie.

Návraty

PerformanceCounterCategory

Objekt PerformanceCounterCategory , který je přidružený k nové vlastní kategorii nebo objektu výkonu.

Výjimky

ArgumentException

Název čítače zadaný v kolekci counterData je null nebo prázdný řetězec ("").

nebo

Čítač zadaný v rámci counterData kolekce již existuje.

ArgumentNullException

categoryName je null.

nebo

counterData je null.

ArgumentOutOfRangeException

categoryType hodnota je mimo rozsah následujících hodnot: MultiInstance, SingleInstancenebo Unknown.

InvalidOperationException

Kategorie již v místním počítači existuje.

nebo

Rozložení counterData kolekce není pro základní čítače správné. Čítač typu AverageCount64, , , , AverageTimer32CounterMultiTimerCounterMultiTimerInverseCounterMultiTimer100NsCounterMultiTimer100NsInverse, RawFractionnebo SampleFraction musí být bezprostředně následovaný jedním ze základních typů čítačů (SampleCounter, AverageBase, MultiBase, nebo ).RawBaseSampleBase

Win32Exception

Volání základního systémového rozhraní API selhalo.

UnauthorizedAccessException

Kód, který se spouští bez oprávnění správce, se pokusil přečíst čítač výkonu.

Příklady

Následující příklad kódu ukazuje použití Create metody. Příklad ukazuje, jak vytvořit vlastní kategorii čítače výkonu s více instancemi pro počet objednávek za sekundu.

CounterCreationData data1 = new CounterCreationData("Trucks",
    "Number of orders", PerformanceCounterType.NumberOfItems32);
CounterCreationData data2 = new CounterCreationData("Rate of sales",
    "Orders/second", PerformanceCounterType.RateOfCountsPerSecond32);
CounterCreationDataCollection ccds = new CounterCreationDataCollection();
ccds.Add(data1);
ccds.Add(data2);
Console.WriteLine("Creating Orders custom counter.");
if (!PerformanceCounterCategory.Exists("Orders"))
    PerformanceCounterCategory.Create("Orders",
        "Processed orders",
        PerformanceCounterCategoryType.MultiInstance,
        ccds);

Dim data1 As New CounterCreationData("Trucks", "Number of orders", PerformanceCounterType.NumberOfItems32)
Dim data2 As New CounterCreationData("Rate of sales", "Orders/second", PerformanceCounterType.RateOfCountsPerSecond32)
Dim ccds As New CounterCreationDataCollection()
ccds.Add(data1)
ccds.Add(data2)
Console.WriteLine("Creating Orders custom counter.")
If Not PerformanceCounterCategory.Exists("Orders") Then
    PerformanceCounterCategory.Create("Orders", "Processed orders", PerformanceCounterCategoryType.MultiInstance, ccds)
End If

Poznámky

Parametr categoryType určuje, jestli je kategorie čítače výkonu jedna instance nebo více instancí. Ve výchozím nastavení je kategorie při vytváření jedna instance a při přidání jiné instance se stane více instancemi. Kategorie se vytvoří při nastavování aplikace a instance se přidají za běhu. Výčet PerformanceCounterCategoryType se používá k označení, zda může mít čítač výkonu více instancí.

Kategorie čítačů výkonu nainstalované s .NET používají samostatnou sdílenou paměť, přičemž každá kategorie čítače výkonu má vlastní paměť. Velikost samostatné sdílené paměti můžete určit vytvořením DWORD s názvem FileMappingSize v klíči registru HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\<název> kategorie\Výkon. Hodnota FileMappingSize je nastavena na velikost sdílené paměti kategorie. Výchozí velikost je 131072 desetinných míst. Pokud hodnota FileMappingSize není k dispozici, fileMappingSize použije se hodnota atributu performanceCounters pro prvek zadaný v souboru Machine.config, což způsobuje další režii při zpracování konfiguračního souboru. Zlepšení výkonu při spuštění aplikace můžete zjistit nastavením velikosti mapování souborů v registru.

Note

Důrazně doporučujeme vytvořit nové kategorie čítačů výkonu během instalace aplikace, ne během provádění aplikace. Díky tomu může operační systém aktualizovat seznam registrovaných kategorií čítačů výkonu. Pokud se seznam neaktualizoval, pokus o použití kategorie selže.

Note

Chcete-li číst čítače výkonu z neinteraktivní přihlašovací relace v systémech Windows Vista a novějších, Windows XP Professional x64 Edition nebo Windows Server 2003, musíte být členem skupiny Uživatelé sledování výkonu nebo mít oprávnění správce.

Abyste se vyhnuli zvýšení oprávnění pro přístup k čítačům výkonu v systému Windows Vista a novějším, přidejte se do skupiny Uživatelé sledování výkonu.

V systému Windows Vista a novějších určuje řízení uživatelských účtů (UAC) oprávnění uživatele. Pokud jste členem předdefinované skupiny Administrators, máte přiřazené dva přístupové tokeny za běhu: standardní přístupový token uživatele a přístupový token správce. Ve výchozím nastavení jste ve standardní roli uživatele. Pokud chcete spustit kód, který přistupuje k čítačům výkonu, musíte nejprve zvýšit oprávnění od standardního uživatele na správce. Můžete to udělat, když spustíte aplikaci tak, že kliknete pravým tlačítkem myši na ikonu aplikace a označíte, že chcete spustit jako správce.

Viz také

• Delete(String)
• Exists(String)
• PerformanceCounter
• CounterCreationDataCollection