PerformanceCounter.InstanceName Özellik

Tanım

Ad Alanı:

System.Diagnostics

Bütünleştirilmiş Kod:

System.Diagnostics.PerformanceCounter.dll

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

Sayaç tek örnekli bir sayaçsa, performans sayacı kategori örneğinin adı veya 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 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

Uyarı

Örnek adlarının uzunluğu 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çermediğinden, 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 örnekleri arasından seçim yapabilirsiniz. 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şturucuda PerformanceCounter bir instanceName belirtin. tarafından instanceName belirtilen kategori örneği zaten varsa, yeni nesne mevcut kategori örneğine başvurur.

Uyarı

Ö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 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.