PerformanceCounterCategory.Create Yöntem

Tanım

Ad Alanı:

System.Diagnostics

Bütünleştirilmiş Kod:

System.Diagnostics.PerformanceCounter.dll

Paket:

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

Özel performans sayacı kategorisini ve bir veya daha fazla sayacı sisteme kaydeder.

Aşırı Yüklemeler

Name	Description
Create(String, String, String, String)	Geçersiz. Yerel bilgisayarda tek bir sayaç türü NumberOfItems32 içeren özel bir performans sayacı kategorisi kaydeder.
Create(String, String, PerformanceCounterCategoryType, String, String)	Yerel bilgisayarda tek bir sayaç türü NumberOfItems32 içeren özel performans sayacı kategorisini kaydeder.
Create(String, String, CounterCreationDataCollection)	Geçersiz. Yerel bilgisayarda belirtilen sayaçları içeren özel performans sayacı kategorisini kaydeder.
Create(String, String, PerformanceCounterCategoryType, CounterCreationDataCollection)	Yerel bilgisayarda belirtilen sayaçları içeren özel performans sayacı kategorisini kaydeder.

Create(String, String, String, String)

Kaynak:

PerformanceCounterCategory.cs

Dikkat

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

Yerel bilgisayarda tek bir sayaç türü NumberOfItems32 içeren özel bir performans sayacı kategorisi kaydeder.

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

Parametreler

categoryName

String

Sistem oluşturulup sisteme kaydedilecek özel performans sayacı kategorisinin adı.

categoryHelp

String

Özel kategorinin açıklaması.

counterName

String

Yeni kategorinin bir parçası olarak oluşturulacak türündeki NumberOfItems32yeni bir sayacın adı.

counterHelp

String

Yeni özel kategoriyle ilişkili sayacın açıklaması.

Döndürülenler

PerformanceCounterCategory

PerformanceCounterCategory Yeni sistem kategorisi veya performans nesnesiyle ilişkilendirilmiş bir.

Öznitelikler

ObsoleteAttribute

Özel durumlar

ArgumentException

counterName veya null boş bir dizedir ("").

-veya-

tarafından counterName belirtilen sayaç zaten var.

-veya-

counterName geçersiz söz dizimi içeriyor. Ters eğik çizgi karakterleri ("\") içerebilir veya uzunluğu 80 karakterden uzun olabilir.

InvalidOperationException

Kategori yerel bilgisayarda zaten var.

ArgumentNullException

categoryName, null'e eşittir.

-veya-

counterHelp, null'e eşittir.

Win32Exception

Temel alınan sistem API'sine yapılan çağrı başarısız oldu.

UnauthorizedAccessException

Yönetici ayrıcalıkları olmadan yürütülen kod bir performans sayacını okumaya çalıştı.

Açıklamalar

Note

Windows Vista ve sonraki sürümlerde, Windows XP Professional x64 Edition'da veya Windows Server 2003'te etkileşimli olmayan bir oturumdan performans sayaçlarını okumak için Performans İzleyicisi Kullanıcıları grubunun üyesi olmanız veya yönetici ayrıcalıklarına sahip olmanız gerekir.

Windows Vista ve sonraki sürümlerde performans sayaçlarına erişmek için ayrıcalıklarınızı yükseltmek zorunda kalmamak için kendinizi Performans İzleyicisi Kullanıcıları grubuna ekleyin.

Windows Vista ve sonraki sürümlerde Kullanıcı Hesabı Denetimi (UAC), bir kullanıcının ayrıcalıklarını belirler. Yerleşik Yöneticiler grubunun üyesiyseniz, size iki çalışma zamanı erişim belirteci atanır: standart kullanıcı erişim belirteci ve yönetici erişim belirteci. Varsayılan olarak, standart kullanıcı rolündesiniz. Performans sayaçlarına erişen kodu yürütmek için öncelikle ayrıcalıklarınızı standart kullanıcıdan yöneticiye yükseltmeniz gerekir. Uygulama simgesine sağ tıklayıp yönetici olarak çalıştırmak istediğinizi belirterek uygulamayı başlattığınızda bunu yapabilirsiniz.

Ayrıca bkz.

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

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

Kaynak:

PerformanceCounterCategory.cs

Yerel bilgisayarda tek bir sayaç türü NumberOfItems32 içeren özel performans sayacı kategorisini kaydeder.

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

Parametreler

categoryName

String

Sistem oluşturulup sisteme kaydedilecek özel performans sayacı kategorisinin adı.

categoryHelp

String

Özel kategorinin açıklaması.

categoryType

PerformanceCounterCategoryType

Kategorinin PerformanceCounterCategoryTypeMultiInstance, SingleInstanceveya Unknownolup olmadığını belirten değerlerden biri.

counterName

String

Yeni kategorinin bir parçası olarak oluşturulacak yeni sayacın adı.

counterHelp

String

Yeni özel kategoriyle ilişkili sayacın açıklaması.

Döndürülenler

PerformanceCounterCategory

PerformanceCounterCategory Yeni sistem kategorisi veya performans nesnesiyle ilişkilendirilmiş bir.

Özel durumlar

ArgumentException

counterName veya null boş bir dizedir ("").

-veya-

tarafından counterName belirtilen sayaç zaten var.

-veya-

counterName geçersiz söz dizimi içeriyor. Ters eğik çizgi karakterleri ("\") içerebilir veya uzunluğu 80 karakterden uzun olabilir.

InvalidOperationException

Kategori yerel bilgisayarda zaten var.

ArgumentNullException

categoryName, null'e eşittir.

-veya-

counterHelp, null'e eşittir.

Win32Exception

Temel alınan sistem API'sine yapılan çağrı başarısız oldu.

UnauthorizedAccessException

Yönetici ayrıcalıkları olmadan yürütülen kod bir performans sayacını okumaya çalıştı.

Örnekler

Aşağıdaki kod örneği yönteminin Create kullanımını gösterir. Örnekte özel, tek örnekli performans sayacı kategorisinin nasıl oluşturulacağı gösterilmektedir.

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

Açıklamalar

parametresi, categoryType performans sayacı kategorisinin tek örnekli mi yoksa çok örnekli mi olduğunu belirtir. Varsayılan olarak, bir kategori oluşturulduğunda tek örnektir ve başka bir örnek eklendiğinde çok örnekli olur. Kategoriler, bir uygulama ayarlandığında oluşturulur ve örnekler çalışma zamanında eklenir. Numaralandırma PerformanceCounterCategoryType , bir performans sayacının birden çok örneği olup olmadığını göstermek için kullanılır.

.NET ile yüklenen performans sayacı kategorileri, her performans sayacı kategorisinin kendi belleğine sahip olduğu ayrı paylaşılan bellek kullanır. Kategori adı\Performans HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\kayıt defteri anahtarında <FileMappingSize adlı bir DWORD oluşturarak ayrı paylaşılan belleğin boyutunu belirtebilirsiniz.> FileMappingSize değeri, kategorinin paylaşılan bellek boyutuna ayarlanır. Varsayılan boyut ondalık 131072. FileMappingSize değeri yoksa, fileMappingSize Machine.config dosyasında belirtilen öğenin öznitelik değeri performanceCounters kullanılır ve bu da yapılandırma dosyası işleme için ek yüke neden olur. Kayıt defterinde dosya eşleme boyutunu ayarlayarak uygulama başlatma için bir performans geliştirmesi gerçekleştirebilirsiniz.

Note

Uygulamanın yürütülmesi sırasında değil, uygulamanın yüklenmesi sırasında yeni performans sayacı kategorilerinin oluşturulması kesinlikle önerilir. Bu, işletim sisteminin kayıtlı performans sayacı kategorileri listesini yenilemesi için zaman sağlar. Liste yenilenmediyse, kategoriyi kullanma girişimi başarısız olur.

Note

Windows Vista ve sonraki sürümlerde, Windows XP Professional x64 Edition'da veya Windows Server 2003'te etkileşimli olmayan bir oturumdan performans sayaçlarını okumak için Performans İzleyicisi Kullanıcıları grubunun üyesi olmanız veya yönetici ayrıcalıklarına sahip olmanız gerekir.

Windows Vista ve sonraki sürümlerde performans sayaçlarına erişmek için ayrıcalıklarınızı yükseltmek zorunda kalmamak için kendinizi Performans İzleyicisi Kullanıcıları grubuna ekleyin.

Windows Vista ve sonraki sürümlerde Kullanıcı Hesabı Denetimi (UAC), bir kullanıcının ayrıcalıklarını belirler. Yerleşik Yöneticiler grubunun üyesiyseniz, size iki çalışma zamanı erişim belirteci atanır: standart kullanıcı erişim belirteci ve yönetici erişim belirteci. Varsayılan olarak, standart kullanıcı rolündesiniz. Performans sayaçlarına erişen kodu yürütmek için öncelikle ayrıcalıklarınızı standart kullanıcıdan yöneticiye yükseltmeniz gerekir. Uygulama simgesine sağ tıklayıp yönetici olarak çalıştırmak istediğinizi belirterek uygulamayı başlattığınızda bunu yapabilirsiniz.

Ayrıca bkz.

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

Create(String, String, CounterCreationDataCollection)

Kaynak:

PerformanceCounterCategory.cs

Dikkat

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

Yerel bilgisayarda belirtilen sayaçları içeren özel performans sayacı kategorisini kaydeder.

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

Parametreler

categoryName

String

Sistem oluşturulup sisteme kaydedilecek özel performans sayacı kategorisinin adı.

categoryHelp

String

Özel kategorinin açıklaması.

counterData

CounterCreationDataCollection

CounterCreationDataCollection Yeni kategorinin bir parçası olarak oluşturulacak sayaçları belirten bir.

Döndürülenler

PerformanceCounterCategory

PerformanceCounterCategory Yeni özel kategori veya performans nesnesiyle ilişkili bir.

Öznitelikler

ObsoleteAttribute

Özel durumlar

ArgumentException

Koleksiyon counterData içinde null belirtilen bir sayaç adı veya boş bir dize ("").

-veya-

Koleksiyonda counterData belirtilen bir sayaç zaten var.

ArgumentNullException

categoryName parametresi null'dir.

InvalidOperationException

Kategori yerel bilgisayarda zaten var.

-veya-

Temel sayaçlar için koleksiyonun counterData düzeni yanlış. , , AverageCount64, AverageTimer32, CounterMultiTimer, CounterMultiTimerInverse, CounterMultiTimer100NsCounterMultiTimer100NsInverseRawFraction veya SampleFraction türünde SampleCounterbir sayacın hemen ardından temel sayaç türlerinden biri (AverageBase, MultiBase, RawBaseveya SampleBase) olması gerekir.

Win32Exception

Temel alınan sistem API'sine yapılan çağrı başarısız oldu.

UnauthorizedAccessException

Yönetici ayrıcalıkları olmadan yürütülen kod bir performans sayacını okumaya çalıştı.

Açıklamalar

Note

Windows Vista ve sonraki sürümlerde, Windows XP Professional x64 Edition'da veya Windows Server 2003'te etkileşimli olmayan bir oturumdan performans sayaçlarını okumak için Performans İzleyicisi Kullanıcıları grubunun üyesi olmanız veya yönetici ayrıcalıklarına sahip olmanız gerekir.

Windows Vista ve sonraki sürümlerde performans sayaçlarına erişmek için ayrıcalıklarınızı yükseltmek zorunda kalmamak için kendinizi Performans İzleyicisi Kullanıcıları grubuna ekleyin.

Windows Vista ve sonraki sürümlerde Kullanıcı Hesabı Denetimi (UAC), bir kullanıcının ayrıcalıklarını belirler. Yerleşik Yöneticiler grubunun üyesiyseniz, size iki çalışma zamanı erişim belirteci atanır: standart kullanıcı erişim belirteci ve yönetici erişim belirteci. Varsayılan olarak, standart kullanıcı rolündesiniz. Performans sayaçlarına erişen kodu yürütmek için öncelikle ayrıcalıklarınızı standart kullanıcıdan yöneticiye yükseltmeniz gerekir. Uygulama simgesine sağ tıklayıp yönetici olarak çalıştırmak istediğinizi belirterek uygulamayı başlattığınızda bunu yapabilirsiniz.

Ayrıca bkz.

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

Create(String, String, PerformanceCounterCategoryType, CounterCreationDataCollection)

Kaynak:

PerformanceCounterCategory.cs

Yerel bilgisayarda belirtilen sayaçları içeren özel performans sayacı kategorisini kaydeder.

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

Parametreler

categoryName

String

Sistem oluşturulup sisteme kaydedilecek özel performans sayacı kategorisinin adı.

categoryHelp

String

Özel kategorinin açıklaması.

categoryType

PerformanceCounterCategoryType

Değerlerden PerformanceCounterCategoryType biri.

counterData

CounterCreationDataCollection

CounterCreationDataCollection Yeni kategorinin bir parçası olarak oluşturulacak sayaçları belirten bir.

Döndürülenler

PerformanceCounterCategory

PerformanceCounterCategory Yeni özel kategori veya performans nesnesiyle ilişkili bir.

Özel durumlar

ArgumentException

Koleksiyon counterData içinde null belirtilen bir sayaç adı veya boş bir dize ("").

-veya-

Koleksiyonda counterData belirtilen bir sayaç zaten var.

ArgumentNullException

categoryName, null'e eşittir.

-veya-

counterData, null'e eşittir.

ArgumentOutOfRangeException

categoryType değeri şu değerlerin aralığının dışındadır: MultiInstance, SingleInstanceveya Unknown.

InvalidOperationException

Kategori yerel bilgisayarda zaten var.

-veya-

Temel sayaçlar için koleksiyonun counterData düzeni yanlış. , , AverageCount64, , , AverageTimer32, CounterMultiTimer, CounterMultiTimerInverseCounterMultiTimer100NsCounterMultiTimer100NsInverseveya RawFraction türünde SampleFractionbir sayacın hemen ardından temel sayaç türlerinden biri (SampleCounter, AverageBase, MultiBaseveya RawBase) bulunmalıdırSampleBase.

Win32Exception

Temel alınan sistem API'sine yapılan çağrı başarısız oldu.

UnauthorizedAccessException

Yönetici ayrıcalıkları olmadan yürütülen kod bir performans sayacını okumaya çalıştı.

Örnekler

Aşağıdaki kod örneği yönteminin Create kullanımını gösterir. Örnekte saniyedeki sipariş sayısı için özel, çok örnekli performans sayacı kategorisinin nasıl oluşturulacağı gösterilmektedir.

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

Açıklamalar

parametresi, categoryType performans sayacı kategorisinin tek örnekli mi yoksa çok örnekli mi olduğunu belirtir. Varsayılan olarak, bir kategori oluşturulduğunda tek örnektir ve başka bir örnek eklendiğinde çok örnekli olur. Kategoriler, bir uygulama ayarlandığında oluşturulur ve örnekler çalışma zamanında eklenir. Numaralandırma PerformanceCounterCategoryType , bir performans sayacının birden çok örneği olup olmadığını göstermek için kullanılır.

.NET ile yüklenen performans sayacı kategorileri, her performans sayacı kategorisinin kendi belleğine sahip olduğu ayrı paylaşılan bellek kullanır. Kategori adı\Performans HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\kayıt defteri anahtarında <FileMappingSize adlı bir DWORD oluşturarak ayrı paylaşılan belleğin boyutunu belirtebilirsiniz.> FileMappingSize değeri, kategorinin paylaşılan bellek boyutuna ayarlanır. Varsayılan boyut ondalık 131072. FileMappingSize değeri yoksa, fileMappingSize Machine.config dosyasında belirtilen öğenin öznitelik değeri performanceCounters kullanılır ve bu da yapılandırma dosyası işleme için ek yüke neden olur. Kayıt defterinde dosya eşleme boyutunu ayarlayarak uygulama başlatma için bir performans geliştirmesi gerçekleştirebilirsiniz.

Note

Uygulamanın yürütülmesi sırasında değil, uygulamanın yüklenmesi sırasında yeni performans sayacı kategorilerinin oluşturulması kesinlikle önerilir. Bu, işletim sisteminin kayıtlı performans sayacı kategorileri listesini yenilemesi için zaman sağlar. Liste yenilenmediyse, kategoriyi kullanma girişimi başarısız olur.

Note

Windows Vista ve sonraki sürümlerde, Windows XP Professional x64 Edition'da veya Windows Server 2003'te etkileşimli olmayan bir oturumdan performans sayaçlarını okumak için Performans İzleyicisi Kullanıcıları grubunun üyesi olmanız veya yönetici ayrıcalıklarına sahip olmanız gerekir.

Windows Vista ve sonraki sürümlerde performans sayaçlarına erişmek için ayrıcalıklarınızı yükseltmek zorunda kalmamak için kendinizi Performans İzleyicisi Kullanıcıları grubuna ekleyin.

Windows Vista ve sonraki sürümlerde Kullanıcı Hesabı Denetimi (UAC), bir kullanıcının ayrıcalıklarını belirler. Yerleşik Yöneticiler grubunun üyesiyseniz, size iki çalışma zamanı erişim belirteci atanır: standart kullanıcı erişim belirteci ve yönetici erişim belirteci. Varsayılan olarak, standart kullanıcı rolündesiniz. Performans sayaçlarına erişen kodu yürütmek için öncelikle ayrıcalıklarınızı standart kullanıcıdan yöneticiye yükseltmeniz gerekir. Uygulama simgesine sağ tıklayıp yönetici olarak çalıştırmak istediğinizi belirterek uygulamayı başlattığınızda bunu yapabilirsiniz.

Ayrıca bkz.

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