PerformanceCounter.InstanceName Özellik
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
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; }
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.InstanceNameConverter, System.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string InstanceName { get; set; }
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.InstanceNameConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string InstanceName { get; set; }
[System.ComponentModel.SettingsBindable(true)]
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.InstanceNameConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string InstanceName { get; set; }
member this.InstanceName : string with get, set
[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.InstanceNameConverter, System.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.InstanceName : string with get, set
[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.InstanceNameConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.InstanceName : string with get, set
[<System.ComponentModel.SettingsBindable(true)>]
[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.InstanceNameConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.InstanceName : string with get, set
Public Property InstanceName As String
Özellik Değeri
Performans sayacı kategorisi örneğinin adı veya sayaç tek örnekli bir sayaçsa boş bir dize ("").
- Öznitelikler
Ö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.