PerformanceCounterCategory.Create Metod

Definition

Namnområde:: System.Diagnostics

Sammansättning:: System.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Registrerar en anpassad prestandaräknarekategori och en eller flera räknare med systemet.

Överlagringar

Name	Description
Create(String, String, String, String)	Föråldrad. Registrerar en anpassad prestandaräknare som innehåller en enskild räknare av typen `NumberOfItems32` på den lokala datorn.
Create(String, String, PerformanceCounterCategoryType, String, String)	Registrerar kategorin för anpassade prestandaräknare som innehåller en enskild räknare av typen NumberOfItems32 på den lokala datorn.
Create(String, String, CounterCreationDataCollection)	Föråldrad. Registrerar kategorin för anpassade prestandaräknare som innehåller de angivna räknarna på den lokala datorn.
Create(String, String, PerformanceCounterCategoryType, CounterCreationDataCollection)	Registrerar kategorin för anpassade prestandaräknare som innehåller de angivna räknarna på den lokala datorn.

Create(String, String, String, String)

Varning

This method has been deprecated. Please use System.Diagnostics.PerformanceCounterCategory.Create(string categoryName, string categoryHelp, PerformanceCounterCategoryType categoryType, string counterName, string counterHelp) instead. http://go.microsoft.com/fwlink/?linkid=14202

Registrerar en anpassad prestandaräknare som innehåller en enskild räknare av typen NumberOfItems32 på den lokala datorn.

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

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

[System.Obsolete("This method has been deprecated.  Please use System.Diagnostics.PerformanceCounterCategory.Create(string categoryName, string categoryHelp, PerformanceCounterCategoryType categoryType, string counterName, string counterHelp) instead.  http://go.microsoft.com/fwlink/?linkid=14202")]
public static System.Diagnostics.PerformanceCounterCategory Create(string categoryName, string categoryHelp, string counterName, string counterHelp);

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

[<System.Obsolete("This method has been deprecated.  Please use System.Diagnostics.PerformanceCounterCategory.Create(string categoryName, string categoryHelp, PerformanceCounterCategoryType categoryType, string counterName, string counterHelp) instead.  http://go.microsoft.com/fwlink/?linkid=14202")>]
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

Parametrar

categoryName: String

Namnet på den anpassade prestandaräknarens kategori för att skapa och registrera med systemet.

categoryHelp: String

En beskrivning av den anpassade kategorin.

counterName: String

Namnet på en ny räknare, av typen NumberOfItems32, som ska skapas som en del av den nya kategorin.

counterHelp: String

En beskrivning av räknaren som är associerad med den nya anpassade kategorin.

Returer

PerformanceCounterCategory

En PerformanceCounterCategory som är associerad med den nya systemkategorin eller prestandaobjektet.

Attribut: ObsoleteAttribute

Undantag

ArgumentException

counterName är null eller är en tom sträng ("").

-eller-

Räknaren som anges av counterName finns redan.

-eller-

counterName har ogiltig syntax. Den kan innehålla omvänt snedstreck ("\") eller ha en längd som är större än 80 tecken.

InvalidOperationException

Kategorin finns redan på den lokala datorn.

ArgumentNullException

categoryName är null.

-eller-

counterHelp är null.

Win32Exception

Ett anrop till ett underliggande system-API misslyckades.

UnauthorizedAccessException

Kod som körs utan administratörsbehörighet försökte läsa en prestandaräknare.

Kommentarer

Anteckning

Om du vill läsa prestandaräknare från en icke-interaktiv inloggningssession i Windows Vista och senare, Windows XP Professional x64 Edition eller Windows Server 2003, måste du antingen vara medlem i gruppen Performance Monitor Användare eller ha administratörsbehörighet.

För att undvika att behöva höja dina privilegier för att få åtkomst till prestandaräknare i Windows Vista och senare lägger du till dig själv i gruppen Performance Monitor Användare.

I Windows Vista och senare bestämmer UAC (User Account Control) en användares behörigheter. Om du är medlem i gruppen Inbyggda administratörer tilldelas du två åtkomsttoken för körning: en standardåtkomsttoken för användare och en administratörsåtkomsttoken. Som standard är du i standardanvändarrollen. Om du vill köra koden som kommer åt prestandaräknare måste du först höja dina privilegier från standardanvändare till administratör. Du kan göra detta när du startar ett program genom att högerklicka på programikonen och ange att du vill köra som administratör.

Se även

Gäller för

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

Registrerar kategorin för anpassade prestandaräknare som innehåller en enskild räknare av typen NumberOfItems32 på den lokala datorn.

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

Parametrar

categoryName: String

Namnet på den anpassade prestandaräknarens kategori för att skapa och registrera med systemet.

categoryHelp: String

En beskrivning av den anpassade kategorin.

categoryType: PerformanceCounterCategoryType

Ett av värdena PerformanceCounterCategoryType som anger om kategorin är MultiInstance, SingleInstanceeller Unknown.

counterName: String

Namnet på en ny räknare som ska skapas som en del av den nya kategorin.

counterHelp: String

En beskrivning av räknaren som är associerad med den nya anpassade kategorin.

Returer

PerformanceCounterCategory

En PerformanceCounterCategory som är associerad med den nya systemkategorin eller prestandaobjektet.

Undantag

ArgumentException

counterName är null eller är en tom sträng ("").

-eller-

Räknaren som anges av counterName finns redan.

-eller-

counterName har ogiltig syntax. Den kan innehålla omvänt snedstreck ("\") eller ha en längd som är större än 80 tecken.

InvalidOperationException

Kategorin finns redan på den lokala datorn.

ArgumentNullException

categoryName är null.

-eller-

counterHelp är null.

Win32Exception

Ett anrop till ett underliggande system-API misslyckades.

UnauthorizedAccessException

Kod som körs utan administratörsbehörighet försökte läsa en prestandaräknare.

Exempel

I följande kodexempel visas hur metoden används Create . Exemplet visar hur du skapar en anpassad prestandaräknare för en enskild instans.

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

Kommentarer

Parametern categoryType anger om prestandaräknarens kategori är eninstans eller flera instanser. Som standard är en kategori eninstans när den skapas och blir flera instanser när en annan instans läggs till. Kategorier skapas när ett program har konfigurerats och instanser läggs till vid körning. Uppräkningen PerformanceCounterCategoryType används för att ange om en prestandaräknare kan ha flera instanser.

Prestandaräknare som installeras med .NET använda separat delat minne, där varje kategori för prestandaräknare har sitt eget minne. Du kan ange storleken på separat delat minne genom att skapa ett DWORD med namnet FileMappingSize i registernyckeln HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\<kategorinamn>\Prestanda. Värdet FileMappingSize är inställt på kategorins delade minnesstorlek. Standardstorleken är 131072 decimal. Om värdet FileMappingSize inte finns fileMappingSize används attributvärdet för elementet performanceCounters som anges i Machine.config-filen, vilket orsakar ytterligare omkostnader för bearbetning av konfigurationsfiler. Du kan se en prestandaförbättring för programstart genom att ange filmappningsstorleken i registret.

Anteckning

Vi rekommenderar starkt att nya prestandaräknare kategorier skapas under installationen av programmet, inte under körningen av programmet. Detta gör det möjligt för operativsystemet att uppdatera sin lista över registrerade kategorier för prestandaräknare. Om listan inte har uppdaterats misslyckas försöket att använda kategorin.

Anteckning

För att undvika att behöva höja dina privilegier för att få åtkomst till prestandaräknare i Windows Vista och senare lägger du till dig själv i gruppen Performance Monitor Användare.

Se även

Gäller för

Create(String, String, CounterCreationDataCollection)

Varning

This method has been deprecated. Please use System.Diagnostics.PerformanceCounterCategory.Create(string categoryName, string categoryHelp, PerformanceCounterCategoryType categoryType, CounterCreationDataCollection counterData) instead. http://go.microsoft.com/fwlink/?linkid=14202

Registrerar kategorin för anpassade prestandaräknare som innehåller de angivna räknarna på den lokala datorn.

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

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

[System.Obsolete("This method has been deprecated.  Please use System.Diagnostics.PerformanceCounterCategory.Create(string categoryName, string categoryHelp, PerformanceCounterCategoryType categoryType, CounterCreationDataCollection counterData) instead.  http://go.microsoft.com/fwlink/?linkid=14202")]
public static System.Diagnostics.PerformanceCounterCategory Create(string categoryName, string categoryHelp, System.Diagnostics.CounterCreationDataCollection counterData);

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

[<System.Obsolete("This method has been deprecated.  Please use System.Diagnostics.PerformanceCounterCategory.Create(string categoryName, string categoryHelp, PerformanceCounterCategoryType categoryType, CounterCreationDataCollection counterData) instead.  http://go.microsoft.com/fwlink/?linkid=14202")>]
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

Parametrar

categoryName: String

Namnet på den anpassade prestandaräknarens kategori för att skapa och registrera med systemet.

categoryHelp: String

En beskrivning av den anpassade kategorin.

counterData: CounterCreationDataCollection

En CounterCreationDataCollection som anger vilka räknare som ska skapas som en del av den nya kategorin.

Returer

PerformanceCounterCategory

En PerformanceCounterCategory som är associerad med den nya anpassade kategorin eller prestandaobjektet.

Attribut: ObsoleteAttribute

Undantag

ArgumentException

Ett räknarnamn som anges i counterData samlingen är null eller en tom sträng ("").

-eller-

Det finns redan en räknare som har angetts i counterData samlingen.

ArgumentNullException

Parametern categoryName är null.

InvalidOperationException

Kategorin finns redan på den lokala datorn.

-eller-

Samlingens counterData layout är felaktig för basräknare. En räknare av typen AverageCount64, AverageTimer32, CounterMultiTimer, CounterMultiTimerInverse, CounterMultiTimer100Ns, CounterMultiTimer100NsInverse, RawFraction, SampleFraction eller SampleCounter måste omedelbart följas av någon av basräknartyperna (AverageBase, MultiBase, RawBaseeller SampleBase).

Win32Exception

Ett anrop till ett underliggande system-API misslyckades.

UnauthorizedAccessException

Kod som körs utan administratörsbehörighet försökte läsa en prestandaräknare.

Kommentarer

Anteckning

För att undvika att behöva höja dina privilegier för att få åtkomst till prestandaräknare i Windows Vista och senare lägger du till dig själv i gruppen Performance Monitor Användare.

Se även

Gäller för

Create(String, String, PerformanceCounterCategoryType, CounterCreationDataCollection)

Registrerar kategorin för anpassade prestandaräknare som innehåller de angivna räknarna på den lokala datorn.

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

Parametrar

categoryName: String

Namnet på den anpassade prestandaräknarens kategori för att skapa och registrera med systemet.

categoryHelp: String

En beskrivning av den anpassade kategorin.

categoryType: PerformanceCounterCategoryType

Ett av PerformanceCounterCategoryType värdena.

counterData: CounterCreationDataCollection

En CounterCreationDataCollection som anger vilka räknare som ska skapas som en del av den nya kategorin.

Returer

PerformanceCounterCategory

En PerformanceCounterCategory som är associerad med den nya anpassade kategorin eller prestandaobjektet.

Undantag

ArgumentException

Ett räknarnamn som anges i counterData samlingen är null eller en tom sträng ("").

-eller-

Det finns redan en räknare som har angetts i counterData samlingen.

ArgumentNullException

categoryName är null.

-eller-

counterData är null.

ArgumentOutOfRangeException

categoryType värdet ligger utanför intervallet för följande värden: MultiInstance, SingleInstanceeller Unknown.

InvalidOperationException

Kategorin finns redan på den lokala datorn.

-eller-

Samlingens counterData layout är felaktig för basräknare. En räknare av typen AverageCount64, AverageTimer32, CounterMultiTimer, CounterMultiTimerInverse, CounterMultiTimer100Ns, CounterMultiTimer100NsInverse, RawFractionSampleFractioneller SampleCounter måste omedelbart följas av någon av basräknartyperna (AverageBase, MultiBase, RawBaseeller SampleBase).

Win32Exception

Ett anrop till ett underliggande system-API misslyckades.

UnauthorizedAccessException

Kod som körs utan administratörsbehörighet försökte läsa en prestandaräknare.

Exempel

I följande kodexempel visas hur metoden används Create . Exemplet visar hur du skapar en anpassad prestandaräknare för flera instanser för antalet beställningar per sekund.

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

Kommentarer

Anteckning

För att undvika att behöva höja dina privilegier för att få åtkomst till prestandaräknare i Windows Vista och senare lägger du till dig själv i gruppen Performance Monitor Användare.

Se även

Gäller för

Feedback

Var den här sidan till hjälp?