PerformanceCounter.InstanceName Özellik

Tanım

Ad Alanı:

System.Diagnostics

Bütünleştirilmiş Kod:

System.Diagnostics.PerformanceCounter.dll

Paket:

System.Diagnostics.PerformanceCounter v8.0.0

Kaynak:

PerformanceCounter.cs

Bu performans sayacı için bir örnek adı alır veya ayarlar.

public:
 property System::String ^ InstanceName { System::String ^ get(); void set(System::String ^ value); };

public string InstanceName { get; set; }

member this.InstanceName : string with get, set

Public Property InstanceName As String

Özellik Değeri

String

Performans sayacı kategorisi örneğinin adı veya sayaç tek örnekli bir sayaçsa boş bir dize ("").

Örnekler

Aşağıdaki kod örneği, sınıfının varsayılan bir örneğini PerformanceCounter oluşturur. Örnek oluşturulduktan CategoryNamesonra , CounterNameve InstanceName özellik değerleri ayarlanır ve yöntemine NextValue yapılan çağrının sonuçları görüntülenir.

PerformanceCounter^ PC = gcnew PerformanceCounter;
PC->CategoryName = "Process";
PC->CounterName = "Private Bytes";
PC->InstanceName = "Explorer";
MessageBox::Show( PC->NextValue().ToString() );

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())

Açıklamalar

Not

Örnek adları 128 karakterden kısa olmalıdır.

Bazı durumlarda kategoriler, bir kategorinin ilişkili olduğu nesnenin birden çok oluşumu hakkındaki verileri izleyen örneklere ayrılır. Örnekler, tek tek sayaçlar yerine kategorinin tamamına uygulanır. Bir kategorideki her sayaç, kategori için tanımlanan her örneğe sahiptir. Örneğin, İşlem kategorisi Idle ve System adlı örnekleri içerir. bu nedenle İşlem kategorisindeki her sayaç, boştaki işlemler veya sistem işlemleri hakkındaki bilgileri gösteren her örnek için veri içerir.

Birçok kategori birden çok örnek içermez, bu nedenle kategoriyle ilişkili örnek olmadığını belirtmek için bu özelliği boş bırakabilirsiniz.

Bu PerformanceCounter örnek özel olmayan bir kategoriye işaret ederse, yalnızca mevcut kategori örneklerinden birini seçebilirsiniz. Yalnızca özel kategorilerde yeni kategori örnekleri oluşturabilirsiniz. Bu sayede ihtiyacınız olan sayıda sayaç ve kategori örneği tanımlayabilirsiniz.

Performans kategorisi örneği oluşturmak için oluşturucu üzerinde PerformanceCounter bir instanceName belirtin. tarafından instanceName belirtilen kategori örneği zaten varsa, yeni nesne mevcut kategori örneğine başvurur.

Not

Örnek adında "(", ")", "#", "\" veya "/" karakterlerini kullanmayın. Bu karakterlerden herhangi biri kullanılırsa, Performans Konsolu (bkz . Çalışma Zamanı Profili Oluşturma) örnek değerlerini doğru görüntülemeyebilir.

Örnek adı otomatik olarak oluşturulursa ve "(", ")", "#", "\" veya "/" karakterlerini içeriyorsa, aşağıdaki tabloda yer alan karakter eşlemesini kullanın.

Karakter	Eşlenen karakter
(	[
)	]
#	_
\	_
/	_

FriendlyName özelliğinden AppDomain.CurrentDomain alınan nesnenin AppDomain özelliği, geçersiz karakterler içerebilen örnek adlarının ortak bir kaynağıdır.