PerformanceCounter Konstruktorer

Definition

Initierar en ny instans av PerformanceCounter klassen.

Överlagringar

Name Description
PerformanceCounter()

Initierar en ny skrivskyddad instans av PerformanceCounter klassen, utan att associera instansen med någon system- eller anpassad prestandaräknare.

PerformanceCounter(String, String)

Initierar en ny skrivskyddad instans av PerformanceCounter klassen och associerar den med det angivna systemet eller den anpassade prestandaräknaren på den lokala datorn. Den här konstruktorn kräver att kategorin har en enda instans.

PerformanceCounter(String, String, Boolean)

Initierar en ny, skrivskyddad eller skrivskyddad instans av klassen och associerar den PerformanceCounter med det angivna systemet eller den anpassade prestandaräknaren på den lokala datorn. Den här konstruktorn kräver att kategorin innehåller en enda instans.

PerformanceCounter(String, String, String)

Initierar en ny skrivskyddad instans av PerformanceCounter klassen och associerar den med det angivna systemet eller den anpassade prestandaräknaren och kategoriinstansen på den lokala datorn.

PerformanceCounter(String, String, String, Boolean)

Initierar en ny, skrivskyddad eller skrivskyddad instans av klassen och associerar den PerformanceCounter med det angivna systemet eller den anpassade prestandaräknaren och kategoriinstansen på den lokala datorn.

PerformanceCounter(String, String, String, String)

Initierar en ny skrivskyddad instans av PerformanceCounter klassen och associerar den med det angivna systemet eller den anpassade prestandaräknaren och kategoriinstansen på den angivna datorn.

PerformanceCounter()

Initierar en ny skrivskyddad instans av PerformanceCounter klassen, utan att associera instansen med någon system- eller anpassad prestandaräknare.

public:
 PerformanceCounter();
public PerformanceCounter();
Public Sub New ()

Exempel

I följande kodexempel skapas en standardinstans av PerformanceCounter klassen. När instansen har skapats CategoryNameanges egenskapsvärdena , CounterNameoch och InstanceName resultatet av ett anrop till NextValue metoden visas.

PerformanceCounter performanceCounter = new PerformanceCounter();
performanceCounter.CategoryName = "Process";
performanceCounter.CounterName = "Private Bytes";
performanceCounter.InstanceName = "Explorer";
MessageBox.Show(performanceCounter.NextValue().ToString());
Dim PC As New PerformanceCounter()
PC.CategoryName = "Process"
PC.CounterName = "Private Bytes"
PC.InstanceName = "Explorer"
MessageBox.Show(PC.NextValue().ToString())

Kommentarer

Den här överlagringen av konstruktorn anger CategoryNameegenskaperna , CounterNameoch InstanceName till tomma strängar (") och anger MachineName egenskapen till den lokala datorn (".").

Den här konstruktorn initierar inte prestandaräknaren, så den associerar inte instansen med en befintlig räknare på den lokala datorn. Om du vill peka på en specifik prestandaräknare anger du CategoryNameegenskaperna , CounterNameoch, om du vill, InstanceName egenskaperna och MachineName innan du läser andra egenskaper eller försöker läsa från en räknare. Om du vill skriva till en prestandaräknare anger du ReadOnly egenskapen till false.

Note

Attributet HostProtectionAttribute som tillämpas på den här medlemmen har följande Resources egenskapsvärde: | SynchronizationSharedState . Påverkar HostProtectionAttribute inte skrivbordsprogram (som vanligtvis startas genom att dubbelklicka på en ikon, skriva ett kommando eller ange en URL i en webbläsare). Mer information finns i klassen HostProtectionAttribute eller SQL Server Programming and Host Protection Attributes.

Gäller för

PerformanceCounter(String, String)

Initierar en ny skrivskyddad instans av PerformanceCounter klassen och associerar den med det angivna systemet eller den anpassade prestandaräknaren på den lokala datorn. Den här konstruktorn kräver att kategorin har en enda instans.

public:
 PerformanceCounter(System::String ^ categoryName, System::String ^ counterName);
public PerformanceCounter(string categoryName, string counterName);
new System.Diagnostics.PerformanceCounter : string * string -> System.Diagnostics.PerformanceCounter
Public Sub New (categoryName As String, counterName As String)

Parametrar

categoryName
String

Namnet på den prestandaräknarekategori (prestandaobjekt) som prestandaräknaren är associerad med.

counterName
String

Namnet på prestandaräknaren.

Undantag

categoryName är en tom sträng ("").

-eller-

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

-eller-

Den angivna kategorin finns inte.

-eller-

Den angivna kategorin markeras som flera instanser och kräver att prestandaräknaren skapas med ett instansnamn.

-eller-

categoryName och counterName har lokaliserats till olika språk.

categoryName eller counterName är null.

Ett fel uppstod vid åtkomst till ett system-API.

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

Kommentarer

Parametersträngarna är inte skiftlägeskänsliga.

Använd den här överlagringen för att komma åt en räknare på den lokala datorn som tillhör en kategori som innehåller en enskild instans av prestandaräknarens kategori. Om du försöker använda den här konstruktorn för att peka den här PerformanceCounter instansen till en kategori som innehåller flera instanser utlöser konstruktorn ett undantag. Den här överlagringen kan komma åt alla skrivskyddade eller skrivskyddade räknare, men gör det i skrivskyddat läge. En PerformanceCounter instans som skapats med den här överbelastningen kan inte skriva till räknaren, även om själva räknaren är läs-/skrivskyddat.

Den här överlagringen av konstruktorn anger CategoryName egenskaperna och CounterName till de värden som du skickar in, anger MachineName egenskapen till den lokala datorn,., och anger InstanceName egenskapen till en tom sträng ("").

Den här konstruktorn initierar prestandaräknaren och associerar instansen med en befintlig räknare (antingen ett system eller en anpassad räknare) på den lokala datorn. De värden som du skickar in för CategoryName egenskaperna och CounterName måste peka på en befintlig prestandaräknare på den lokala datorn.

Note

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.

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

I Windows Vista 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.

Gäller för

PerformanceCounter(String, String, Boolean)

Initierar en ny, skrivskyddad eller skrivskyddad instans av klassen och associerar den PerformanceCounter med det angivna systemet eller den anpassade prestandaräknaren på den lokala datorn. Den här konstruktorn kräver att kategorin innehåller en enda instans.

public:
 PerformanceCounter(System::String ^ categoryName, System::String ^ counterName, bool readOnly);
public PerformanceCounter(string categoryName, string counterName, bool readOnly);
new System.Diagnostics.PerformanceCounter : string * string * bool -> System.Diagnostics.PerformanceCounter
Public Sub New (categoryName As String, counterName As String, readOnly As Boolean)

Parametrar

categoryName
String

Namnet på den prestandaräknarekategori (prestandaobjekt) som prestandaräknaren är associerad med.

counterName
String

Namnet på prestandaräknaren.

readOnly
Boolean

true för att komma åt räknaren i skrivskyddat läge (även om själva räknaren kan vara skrivskyddad); false för att komma åt räknaren i läs-/skrivläge.

Undantag

categoryName är en tom sträng ("").

-eller-

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

-eller-

Den angivna kategorin finns inte. (om readOnly är true).

-eller-

Den angivna kategorin är inte en anpassad kategori för .NET Framework (om readOnly är false).

-eller-

Den angivna kategorin markeras som flera instanser och kräver att prestandaräknaren skapas med ett instansnamn.

-eller-

categoryName och counterName har lokaliserats till olika språk.

categoryName eller counterName är null.

Ett fel uppstod vid åtkomst till ett system-API.

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

Exempel

I följande kodexempel skapas en instans av PerformanceCounter klassen. Exemplet skickas i kategorinamn, räknarnamn och ett flaggvärde som anger att räknaren inte är skrivskyddad. Det här kodexemplet är en del av ett större exempel för PerformanceCounter klassen.

avgCounter64Sample = new PerformanceCounter("AverageCounter64SampleCategory",
    "AverageCounter64Sample",
    false);
avgCounter64Sample = New PerformanceCounter("AverageCounter64SampleCategory", "AverageCounter64Sample", False)

Kommentarer

Parametersträngarna är inte skiftlägeskänsliga.

Använd den här överlagringen för att komma åt en skrivskyddad eller skrivskyddad räknare på den lokala datorn som tillhör en kategori som innehåller en enda instans av prestandaräknarens kategori. Om du försöker använda den här konstruktorn för att peka den här PerformanceCounter instansen till en kategori som innehåller flera instanser utlöser konstruktorn ett undantag.

Den här överlagringen av konstruktorn anger CategoryNameegenskaperna , CounterNameoch ReadOnly till de värden som du skickar in, anger MachineName egenskapen till den lokala datorn ,. och anger InstanceName egenskapen till en tom sträng ("").

Den här konstruktorn initierar prestandaräknaren och associerar instansen med en befintlig räknare (antingen ett system eller en anpassad räknare) på den lokala datorn. De värden som du skickar in för CategoryName egenskaperna och CounterName måste peka på en befintlig prestandaräknare på den lokala datorn. Om prestandaräknarens instans som du pekar på inte är giltig utlöser anropet av konstruktorn ett undantag.

Note

Du kan använda den här överbelastningen för att ansluta till en systemräknare, men du kan inte skriva till en systemräknare. Därför leder inställningen readOnly till false när du ansluter till en systemräknare att konstruktorn utlöser ett undantag.

Note

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.

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

I Windows Vista 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.

Gäller för

PerformanceCounter(String, String, String)

Initierar en ny skrivskyddad instans av PerformanceCounter klassen och associerar den med det angivna systemet eller den anpassade prestandaräknaren och kategoriinstansen på den lokala datorn.

public:
 PerformanceCounter(System::String ^ categoryName, System::String ^ counterName, System::String ^ instanceName);
public PerformanceCounter(string categoryName, string counterName, string instanceName);
new System.Diagnostics.PerformanceCounter : string * string * string -> System.Diagnostics.PerformanceCounter
Public Sub New (categoryName As String, counterName As String, instanceName As String)

Parametrar

categoryName
String

Namnet på den prestandaräknarekategori (prestandaobjekt) som prestandaräknaren är associerad med.

counterName
String

Namnet på prestandaräknaren.

instanceName
String

Namnet på prestandaräknarens kategoriinstans eller en tom sträng (""), om kategorin innehåller en enda instans.

Undantag

categoryName är en tom sträng ("").

-eller-

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

-eller-

Den angivna kategorin är ogiltig.

-eller-

Den angivna kategorin markeras som flera instanser och kräver att prestandaräknaren skapas med ett instansnamn.

-eller-

instanceName är längre än 127 tecken.

-eller-

categoryName och counterName har lokaliserats till olika språk.

categoryName eller counterName är null.

Ett fel uppstod vid åtkomst till ett system-API.

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

Kommentarer

Parametersträngarna är inte skiftlägeskänsliga.

Den här överlagringen av konstruktorn anger CategoryNameegenskaperna , CounterNameoch InstanceName till de värden som du skickar in och anger MachineName egenskapen till den lokala datorn, ".".

Den här konstruktorn initierar prestandaräknaren och associerar instansen med en befintlig räknare (antingen ett system eller en anpassad räknare) på den lokala datorn. De värden som du skickar in för CategoryNameegenskaperna , CounterNameoch InstanceName måste peka på en befintlig prestandaräknare på den lokala datorn. Om prestandaräknarens instans som du pekar på inte är giltig genererar anrop till konstruktorn ett undantag.

Den här överlagringen kan komma åt alla skrivskyddade eller skrivskyddade räknare, men gör det i skrivskyddat läge. En PerformanceCounter instans som skapats med den här överbelastningen kan inte skriva till räknaren, även om själva räknaren är läs-/skrivskyddat.

Om du vill skapa en instans av prestandakategori anger du en instanceNamePerformanceCounter konstruktorn. Om kategoriinstansen som anges av instanceName redan finns refererar det nya objektet till den befintliga kategoriinstansen.

Note

Om du vill läsa prestandaräknare i Windows Vista, 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.

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

I Windows Vista 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.

Gäller för

PerformanceCounter(String, String, String, Boolean)

Initierar en ny, skrivskyddad eller skrivskyddad instans av klassen och associerar den PerformanceCounter med det angivna systemet eller den anpassade prestandaräknaren och kategoriinstansen på den lokala datorn.

public:
 PerformanceCounter(System::String ^ categoryName, System::String ^ counterName, System::String ^ instanceName, bool readOnly);
public PerformanceCounter(string categoryName, string counterName, string instanceName, bool readOnly);
new System.Diagnostics.PerformanceCounter : string * string * string * bool -> System.Diagnostics.PerformanceCounter
Public Sub New (categoryName As String, counterName As String, instanceName As String, readOnly As Boolean)

Parametrar

categoryName
String

Namnet på den prestandaräknarekategori (prestandaobjekt) som prestandaräknaren är associerad med.

counterName
String

Namnet på prestandaräknaren.

instanceName
String

Namnet på prestandaräknarens kategoriinstans eller en tom sträng (""), om kategorin innehåller en enda instans.

readOnly
Boolean

true för att få åtkomst till en räknare i skrivskyddat läge. false för att komma åt en räknare i läs-/skrivläge.

Undantag

categoryName är en tom sträng ("").

-eller-

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

-eller-

Den begärda behörighetsinställningen för läsning/skrivning är ogiltig för den här räknaren.

-eller-

Den angivna kategorin finns inte (om readOnly är true).

-eller-

Den angivna kategorin är inte en anpassad kategori för .NET Framework (om readOnly är false).

-eller-

Den angivna kategorin markeras som flera instanser och kräver att prestandaräknaren skapas med ett instansnamn.

-eller-

instanceName är längre än 127 tecken.

-eller-

categoryName och counterName har lokaliserats till olika språk.

categoryName eller counterName är null.

Ett fel uppstod vid åtkomst till ett system-API.

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

Kommentarer

Parametersträngarna är inte skiftlägeskänsliga.

Använd den här överlagringen för att komma åt en prestandaräknare i skrivskyddat läge eller skrivskyddat läge.

Den här överlagringen av konstruktorn anger CategoryNameegenskaperna , CounterNameoch InstanceName till de värden som du skickar in, den och anger MachineName egenskapen till den lokala datorn, ".".

Den här konstruktorn initierar prestandaräknaren och associerar instansen med en befintlig räknare (antingen ett system eller en anpassad räknare) på den lokala datorn. De värden som du skickar in för CategoryNameegenskaperna , CounterNameoch InstanceName måste peka på en befintlig prestandaräknare på den lokala datorn. Om prestandaräknarens instans som du pekar på inte är giltig utlöser anropet av konstruktorn ett undantag.

Note

Du kan använda den här överbelastningen för att ansluta till en systemräknare, men du kan inte skriva till en systemräknare. Därför leder inställningen readOnly till false när du ansluter till en systemräknare att konstruktorn utlöser ett undantag.

Om du vill skapa en instans av prestandakategori anger du en instanceNamePerformanceCounter konstruktorn. Om kategoriinstansen som anges av instanceName redan finns refererar det nya objektet till den befintliga kategoriinstansen.

Note

Om du vill läsa prestandaräknare i Windows Vista, 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.

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

I Windows Vista 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.

Gäller för

PerformanceCounter(String, String, String, String)

Initierar en ny skrivskyddad instans av PerformanceCounter klassen och associerar den med det angivna systemet eller den anpassade prestandaräknaren och kategoriinstansen på den angivna datorn.

public:
 PerformanceCounter(System::String ^ categoryName, System::String ^ counterName, System::String ^ instanceName, System::String ^ machineName);
public PerformanceCounter(string categoryName, string counterName, string instanceName, string machineName);
new System.Diagnostics.PerformanceCounter : string * string * string * string -> System.Diagnostics.PerformanceCounter
Public Sub New (categoryName As String, counterName As String, instanceName As String, machineName As String)

Parametrar

categoryName
String

Namnet på den prestandaräknarekategori (prestandaobjekt) som prestandaräknaren är associerad med.

counterName
String

Namnet på prestandaräknaren.

instanceName
String

Namnet på prestandaräknarens kategoriinstans eller en tom sträng (""), om kategorin innehåller en enda instans.

machineName
String

Den dator där prestandaräknaren och dess associerade kategori finns.

Undantag

categoryName är en tom sträng ("").

-eller-

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

-eller-

Den begärda behörighetsinställningen för läsning/skrivning är ogiltig för den här räknaren.

-eller-

Räknaren finns inte på den angivna datorn.

-eller-

Den angivna kategorin markeras som flera instanser och kräver att prestandaräknaren skapas med ett instansnamn.

-eller-

instanceName är längre än 127 tecken.

-eller-

categoryName och counterName har lokaliserats till olika språk.

Parametern machineName är inte giltig.

categoryName eller counterName är null.

Ett fel uppstod vid åtkomst till ett system-API.

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

Kommentarer

Parametersträngarna är inte skiftlägeskänsliga.

Den här överlagringen av konstruktorn anger CategoryNameegenskaperna , CounterName, InstanceNameoch MachineName till de värden som du skickar in.

Den här konstruktorn initierar prestandaräknaren och associerar instansen med en befintlig räknare (antingen ett system eller en anpassad räknare) på den angivna datorn. De värden som du skickar in för CategoryNameegenskaperna , CounterNameInstanceName och MachineName måste peka på en befintlig prestandaräknare. Om prestandaräknarens instans som du pekar på inte är giltig genererar anrop till konstruktorn ett undantag. Den här överlagringen kan komma åt alla skrivskyddade eller skrivskyddade räknare, men gör det i skrivskyddat läge. En PerformanceCounter instans som skapats med den här överbelastningen kan inte skriva till räknaren, även om själva räknaren är läs-/skrivskyddat.

Note

Du kan inte skriva till fjärrprestandaräknare. Det finns ingen överlagring som gör att du kan ange en läs-/skrivinstans av PerformanceCounter klassen som ansluter till en fjärrdator.

Om du vill skapa en instans av prestandakategori anger du en instanceNamePerformanceCounter konstruktorn. Om kategoriinstansen som anges av instanceName redan finns refererar det nya objektet till den befintliga kategoriinstansen.

Note

Om du vill läsa prestandaräknare i Windows Vista, 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.

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

I Windows Vista 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.

Note

När fjärrdatorn är medlem i en arbetsgrupp i Windows Vista kan du behöva inaktivera UAC så att det lokala användarkontot inte filtreras och kan utökas till ett administratörskonto. Av säkerhetsskäl bör inaktivering av UAC vara en sista utväg. Information om hur du inaktiverar UAC finns i User Account Control och WMI.

Gäller för