PerformanceCounterCategory.Create Methode

Definitie

Naamruimte:: System.Diagnostics

Assembly:: System.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Registreert een aangepaste prestatiemeteritemcategorie en een of meer tellers bij het systeem.

Overloads

Name	Description
Create(String, String, String, String)	Verouderd. Registreert een aangepaste prestatiemeteritemcategorie met één teller van het type `NumberOfItems32` op de lokale computer.
Create(String, String, PerformanceCounterCategoryType, String, String)	Registreert de aangepaste prestatiemeteritemcategorie met één teller van het type NumberOfItems32 op de lokale computer.
Create(String, String, CounterCreationDataCollection)	Verouderd. Registreert de aangepaste prestatiemeteritemcategorie met de opgegeven tellers op de lokale computer.
Create(String, String, PerformanceCounterCategoryType, CounterCreationDataCollection)	Registreert de aangepaste prestatiemeteritemcategorie met de opgegeven tellers op de lokale computer.

Create(String, String, String, String)

Let op

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

Registreert een aangepaste prestatiemeteritemcategorie met één teller van het type NumberOfItems32 op de lokale computer.

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

Parameters

categoryName: String

De naam van de aangepaste prestatiemeteritemcategorie die u wilt maken en registreren bij het systeem.

categoryHelp: String

Een beschrijving van de aangepaste categorie.

counterName: String

De naam van een nieuwe teller, van het type NumberOfItems32, die moet worden gemaakt als onderdeel van de nieuwe categorie.

counterHelp: String

Een beschrijving van de teller die is gekoppeld aan de nieuwe aangepaste categorie.

Retouren

PerformanceCounterCategory

Een PerformanceCounterCategory die is gekoppeld aan de nieuwe systeemcategorie of het prestatieobject.

Kenmerken: ObsoleteAttribute

Uitzonderingen

ArgumentException

counterName is null of is een lege tekenreeks ("").

– of –

De teller die is opgegeven door counterName bestaat al.

– of –

counterName heeft een ongeldige syntaxis. Het kan backslashtekens ("\") bevatten of een lengte van meer dan 80 tekens hebben.

InvalidOperationException

De categorie bestaat al op de lokale computer.

ArgumentNullException

categoryName is null.

– of –

counterHelp is null.

Win32Exception

Een aanroep naar een onderliggende systeem-API is mislukt.

UnauthorizedAccessException

Code die wordt uitgevoerd zonder beheerdersbevoegdheden heeft geprobeerd een prestatiemeteritem te lezen.

Opmerkingen

Note

Als u prestatiemeteritems wilt lezen van een niet-interactieve aanmeldingssessie in Windows Vista en hoger, Windows XP Professional x64 Edition of Windows Server 2003, moet u lid zijn van de groep Performance Monitor Gebruikers of beheerdersbevoegdheden hebben.

Als u wilt voorkomen dat u uw bevoegdheden voor toegang tot prestatiemeteritems in Windows Vista en hoger moet verhogen, voegt u uzelf toe aan de groep Performance Monitor Gebruikers.

In Windows Vista en hoger bepaalt UAC (User Account Control) de bevoegdheden van een gebruiker. Als u lid bent van de groep Ingebouwde beheerders, hebt u twee runtime-toegangstokens toegewezen: een standaard toegangstoken voor gebruikers en een beheerderstoegangstoken. Standaard hebt u de standaardgebruikersrol. Als u de code wilt uitvoeren die toegang heeft tot prestatiemeteritems, moet u eerst uw bevoegdheden verhogen van de standaardgebruiker naar de beheerder. U kunt dit doen wanneer u een toepassing start door met de rechtermuisknop op het toepassingspictogram te klikken en aan te geven dat u wilt uitvoeren als beheerder.

Zie ook

Van toepassing op

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

Registreert de aangepaste prestatiemeteritemcategorie met één teller van het type NumberOfItems32 op de lokale computer.

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

Parameters

categoryName: String

De naam van de aangepaste prestatiemeteritemcategorie die u wilt maken en registreren bij het systeem.

categoryHelp: String

Een beschrijving van de aangepaste categorie.

categoryType: PerformanceCounterCategoryType

Een van de PerformanceCounterCategoryType waarden die aangeven of de categorie , MultiInstance SingleInstanceof Unknown.

counterName: String

De naam van een nieuwe teller die moet worden gemaakt als onderdeel van de nieuwe categorie.

counterHelp: String

Een beschrijving van de teller die is gekoppeld aan de nieuwe aangepaste categorie.

Retouren

PerformanceCounterCategory

Een PerformanceCounterCategory die is gekoppeld aan de nieuwe systeemcategorie of het prestatieobject.

Uitzonderingen

ArgumentException

counterName is null of is een lege tekenreeks ("").

– of –

De teller die is opgegeven door counterName bestaat al.

– of –

counterName heeft een ongeldige syntaxis. Het kan backslashtekens ("\") bevatten of een lengte van meer dan 80 tekens hebben.

InvalidOperationException

De categorie bestaat al op de lokale computer.

ArgumentNullException

categoryName is null.

– of –

counterHelp is null.

Win32Exception

Een aanroep naar een onderliggende systeem-API is mislukt.

UnauthorizedAccessException

Code die wordt uitgevoerd zonder beheerdersbevoegdheden heeft geprobeerd een prestatiemeteritem te lezen.

Voorbeelden

In het volgende codevoorbeeld ziet u het gebruik van de Create methode. In het voorbeeld ziet u hoe u een aangepaste prestatiemeteritemcategorie voor één exemplaar maakt.

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

Opmerkingen

De categoryType parameter geeft aan of de prestatiemeteritemcategorie één exemplaar of meerdere exemplaren is. Een categorie is standaard één exemplaar wanneer deze wordt gemaakt en wordt meerdere exemplaren wanneer een andere instantie wordt toegevoegd. Categorieën worden gemaakt wanneer een toepassing is ingesteld en exemplaren worden toegevoegd tijdens de runtime. De PerformanceCounterCategoryType opsomming wordt gebruikt om aan te geven of een prestatiemeteritem meerdere exemplaren kan hebben.

Prestatiemeteritemscategorieën die zijn geïnstalleerd met .NET afzonderlijke gedeelde geheugen gebruiken, waarbij elke prestatiemeteritemcategorie een eigen geheugen heeft. U kunt de grootte van het afzonderlijke gedeelde geheugen opgeven door een DWORD met de naam FileMappingSize te maken in de registersleutel HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\<categorienaam>\Prestaties. De waarde FileMappingSize is ingesteld op de grootte van het gedeelde geheugen van de categorie. De standaardgrootte is 131072 decimaal. Als de FileMappingSize-waarde niet aanwezig is, wordt de fileMappingSize kenmerkwaarde voor het performanceCounters element dat is opgegeven in het Machine.config-bestand gebruikt, wat extra overhead voor de verwerking van configuratiebestanden veroorzaakt. U kunt een prestatieverbetering voor het opstarten van toepassingen realiseren door de bestandsgrootte in het register in te stellen.

Note

Het wordt sterk aanbevolen om nieuwe prestatiemeteritems te maken tijdens de installatie van de toepassing, niet tijdens de uitvoering van de toepassing. Hierdoor kan het besturingssysteem de lijst met geregistreerde prestatiemeteritemscategorieën vernieuwen. Als de lijst niet is vernieuwd, mislukt de poging om de categorie te gebruiken.

Note

Als u wilt voorkomen dat u uw bevoegdheden voor toegang tot prestatiemeteritems in Windows Vista en hoger moet verhogen, voegt u uzelf toe aan de groep Performance Monitor Gebruikers.

Zie ook

Van toepassing op

Create(String, String, CounterCreationDataCollection)

Let op

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

Registreert de aangepaste prestatiemeteritemcategorie met de opgegeven tellers op de lokale computer.

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

Parameters

categoryName: String

De naam van de aangepaste prestatiemeteritemcategorie die u wilt maken en registreren bij het systeem.

categoryHelp: String

Een beschrijving van de aangepaste categorie.

counterData: CounterCreationDataCollection

Een CounterCreationDataCollection die de tellers aangeeft die moeten worden gemaakt als onderdeel van de nieuwe categorie.

Retouren

PerformanceCounterCategory

Een PerformanceCounterCategory die is gekoppeld aan de nieuwe aangepaste categorie of het prestatieobject.

Kenmerken: ObsoleteAttribute

Uitzonderingen

ArgumentException

Een tellernaam die in de counterData verzameling is opgegeven, is null of een lege tekenreeks ("").

– of –

Er bestaat al een teller die is opgegeven in de counterData verzameling.

ArgumentNullException

De categoryName parameter is null.

InvalidOperationException

De categorie bestaat al op de lokale computer.

– of –

De indeling van de counterData verzameling is onjuist voor basistellers. Een teller van het type AverageCount64, , AverageTimer32CounterMultiTimer, CounterMultiTimerInverse, CounterMultiTimer100Ns, CounterMultiTimer100NsInverseof SampleFractionRawFractionSampleCounter moet onmiddellijk worden gevolgd door een van de basistellertypen (AverageBase, MultiBase, RawBaseof SampleBase).

Win32Exception

Een aanroep naar een onderliggende systeem-API is mislukt.

UnauthorizedAccessException

Code die wordt uitgevoerd zonder beheerdersbevoegdheden heeft geprobeerd een prestatiemeteritem te lezen.

Opmerkingen

Note

Als u wilt voorkomen dat u uw bevoegdheden voor toegang tot prestatiemeteritems in Windows Vista en hoger moet verhogen, voegt u uzelf toe aan de groep Performance Monitor Gebruikers.

Zie ook

Van toepassing op

Create(String, String, PerformanceCounterCategoryType, CounterCreationDataCollection)

Registreert de aangepaste prestatiemeteritemcategorie met de opgegeven tellers op de lokale computer.

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

Parameters

categoryName: String

De naam van de aangepaste prestatiemeteritemcategorie die u wilt maken en registreren bij het systeem.

categoryHelp: String

Een beschrijving van de aangepaste categorie.

categoryType: PerformanceCounterCategoryType

Een van de PerformanceCounterCategoryType waarden.

counterData: CounterCreationDataCollection

Een CounterCreationDataCollection die de tellers aangeeft die moeten worden gemaakt als onderdeel van de nieuwe categorie.

Retouren

PerformanceCounterCategory

Een PerformanceCounterCategory die is gekoppeld aan de nieuwe aangepaste categorie of het prestatieobject.

Uitzonderingen

ArgumentException

Een tellernaam die in de counterData verzameling is opgegeven, is null of een lege tekenreeks ("").

– of –

Er bestaat al een teller die is opgegeven in de counterData verzameling.

ArgumentNullException

categoryName is null.

– of –

counterData is null.

ArgumentOutOfRangeException

categoryType de waarde valt buiten het bereik van de volgende waarden: MultiInstance, SingleInstanceof Unknown.

InvalidOperationException

De categorie bestaat al op de lokale computer.

– of –

De indeling van de counterData verzameling is onjuist voor basistellers. Een teller van het type AverageCount64, , CounterMultiTimerAverageTimer32, CounterMultiTimerInverse, CounterMultiTimer100Ns, CounterMultiTimer100NsInverse, , RawFractionof SampleCounterSampleFractionmoet onmiddellijk worden gevolgd door een van de basistellertypen (AverageBase, MultiBase, RawBaseof SampleBase).

Win32Exception

Een aanroep naar een onderliggende systeem-API is mislukt.

UnauthorizedAccessException

Code die wordt uitgevoerd zonder beheerdersbevoegdheden heeft geprobeerd een prestatiemeteritem te lezen.

Voorbeelden

In het volgende codevoorbeeld ziet u het gebruik van de Create methode. In het voorbeeld ziet u hoe u een aangepaste prestatiemeteritemcategorie met meerdere exemplaren maakt voor het aantal orders per seconde.

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

Opmerkingen

Note

Als u wilt voorkomen dat u uw bevoegdheden voor toegang tot prestatiemeteritems in Windows Vista en hoger moet verhogen, voegt u uzelf toe aan de groep Performance Monitor Gebruikers.

Zie ook

Van toepassing op

Feedback

Is deze pagina nuttig?