System.Diagnostics.PerformanceData Ad Alanı
Ö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.
Sayaç verileri sağlamak için bu ad alanında sınıfları kullanın. Sayaçlar, performans ölçümlerini Performans İzleyicisi gibi tüketicilere göstermek için kullanılır. Ad alanı, sayaç verilerinin tüketilmesine yönelik sınıflar içermez. Performans sayaçları mimarisinin tam açıklaması için bkz. Performans Sayaçları.
Sınıflar
| CounterData |
Sayacın ham verilerini içerir. |
| CounterSet |
Bir mantıksal sayaç kümesi tanımlar. |
| CounterSetInstance |
sınıfında tanımlanan mantıksal sayaçların bir örneğini CounterSet oluşturur. |
| CounterSetInstanceCounterDataSet |
Sayaç değerlerinin koleksiyonunu içerir. |
Numaralandırmalar
| CounterSetInstanceType |
Sayaç kümesinin işlemler ve fiziksel diskler gibi birden çok örneğe veya bellek gibi tek bir örneğe izin verip vermeyeceğini belirtir. |
| CounterType |
Olası sayaç türlerini tanımlar. Her sayaça bir sayaç türü atanır. Sayaç türü, sayaç verilerinin nasıl hesaplanıp ortalama alındığını ve görüntüleneceğini belirler. |
Örnekler
Aşağıda basit bir bildirim gösterilmektedir:
<!-- <?xml version="1.0" encoding="UTF-16"?> -->
<instrumentationManifest xsi:schemaLocation="http://schemas.microsoft.com/win/2004/08/events eventman.xsd"
xmlns:win="http://manifests.microsoft.com/win/2004/08/windows/events"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:trace=http://schemas.microsoft.com/win/2004/08/events/trace>
<instrumentation>
<counters xmlns=http://schemas.microsoft.com/win/2005/12/counters>
<provider
applicationIdentity = "provider1.exe"
providerType = "userMode"
providerGuid = "{51D1685C-35ED-45be-99FE-17261A4F27F3}">
<counterSet guid = "{582803C9-AACD-45e5-8C30-571141A22092}"
uri = "Microsoft.Windows.System.PerfCounters.Typing"
name = "$(string.CounterSet1.Name)"
description = "$(string.CounterSet1.Description)"
instances = "single">
<counter id = "1"
uri = "Microsoft.Windows.System.PerfCounters.Typing.TotalWords"
name = "$(string.CS1.Counter1.Name)"
description = "$(string.CS1.Counter1.Description)"
type = "perf_counter_rawcount"
detailLevel = "standard"/>
<counter id = "2"
uri = "Microsoft.Windows.System.PerfCounters.Typing.WordsInInterval"
name = "$(string.CS1.Counter2.Name)"
description = "$(string.CS1.Counter2.Description)"
type = "perf_counter_delta"
detailLevel = "standard"/>
<counter id = "3"
uri = "Microsoft.Windows.System.PerfCounters.Typing.LetterAPressed"
name = "$(string.CS1.Counter3.Name)"
description = "$(string.CS1.Counter3.Description)"
type = "perf_counter_rawcount"
detailLevel = "standard"/>
<counter id = "4"
uri = "Microsoft.Windows.System.PerfCounters.Typing.WordsContainingLetterA"
name = "$(string.CS1.Counter4.Name)"
description = "$(string.CS1.Counter4.Description)"
type = "perf_counter_rawcount"
detailLevel = "standard"/>
<counter id = "5"
uri = "Microsoft.Windows.System.PerfCounters.Typing.PercentOfWordsContainingLetterA"
name = "$(string.CS1.Counter5.Name)"
description = "$(string.CS1.Counter5.Description)"
type = "perf_sample_fraction"
baseID = "6"
detailLevel = "standard">
<counterAttributes>
<counterAttribute name = "displayAsReal" />
</counterAttributes>
</counter>
<counter id = "6"
uri = "Microsoft.Windows.System.PerfCounters.Typing.PercentBase"
type = "perf_sample_base"
detailLevel = "standard">
<counterAttributes>
<counterAttribute name = "noDisplay" />
</counterAttributes>
</counter>
</counterSet>
</provider>
</counters>
</instrumentation>
<localization>
<resources culture="en-US">
<stringTable>
<string id="CounterSet1.Name" value="Typing"/>
<string id="CounterSet1.Description" value="Captures simple typing metrics."/>
<string id="CS1.Counter1.Name" value="Total Words Typed"/>
<string id="CS1.Counter1.Description" value="The total number of words typed."/>
<string id="CS1.Counter2.Name" value="Words Typed In Interval"/>
<string id="CS1.Counter2.Description" value="The total number of words typed in the interval."/>
<string id="CS1.Counter3.Name" value="Letter A Pressed"/>
<string id="CS1.Counter3.Description" value="The number of times that the letter A is pressed."/>
<string id="CS1.Counter4.Name" value="Words Containing A"/>
<string id="CS1.Counter4.Description" value="The number of words that contain the letter A."/>
<string id="CS1.Counter5.Name" value="Percent of Words Containing A"/>
<string id="CS1.Counter5.Description" value="The percent of words that contain the letter A in the last interval."/>
</stringTable>
</resources>
</localization>
</instrumentationManifest>
Aşağıda bildirim için basit bir sağlayıcı uygulaması gösterilmektedir:
using System.Diagnostics.PerformanceData;
private static Guid providerId = new Guid("{51D1685C-35ED-45be-99FE-17261A4F27F3}");
private static Guid typingCounterSetId = new Guid("{582803C9-AACD-45e5-8C30-571141A22092}");
private static CounterSet typingCounterSet; // Defines the counter set
private static CounterSetInstance typingCsInstance; // Instance of the counter set
private static int numberOfLetterAInWord = 0;
. . .
// Create the 'Typing' counter set.
typingCounterSet = new CounterSet(providerId, typingCounterSetId, CounterSetInstanceType.Single);
// Add the counters to the counter set definition.
typingCounterSet.AddCounter(1, CounterType.RawData32, "Total Word Count");
typingCounterSet.AddCounter(2, CounterType.Delta32, "Words Typed In Interval");
typingCounterSet.AddCounter(3, CounterType.RawData32, "A Key Pressed");
typingCounterSet.AddCounter(4, CounterType.RawData32, "Words Containing A");
typingCounterSet.AddCounter(5, CounterType.SampleFraction, "Percent of Words Containing A");
typingCounterSet.AddCounter(6, CounterType.SampleBase, "Percent Base");
// Create an instance of the counter set (contains the counter data).
typingCsInstance = typingCounterSet.CreateCounterSetInstance("Typing Instance");
typingCsInstance.Counters[1].Value = 0;
typingCsInstance.Counters[2].Value = 0;
typingCsInstance.Counters[3].Value = 0;
typingCsInstance.Counters[4].Value = 0;
typingCsInstance.Counters[5].Value = 0;
typingCsInstance.Counters[6].Value = 0;
. . .
private void Form1_FormClosing(object sender, FormClosingEventArgs e)
{
typingCounterSet.Dispose();
}
// Simple effort to capture letter A key press and words typed.
private void textInput_KeyDown(object sender, KeyEventArgs e)
{
Keys keyData = e.KeyData;
switch (e.KeyData)
{
case Keys.A :
// In the .NET 3.5 Framework, you had to use the
// Value property to set and increment the counter
// value. Beginning with the .NET 4.0 Framework,
// the Value property is safe to use in a multi-
// threaded application.
typingCsInstance.Counters["A Key Pressed"].Value++;
numberOfLetterAInWord++;
break;
case Keys.Enter:
case Keys.Space:
case Keys.Tab:
if (numberOfLetterAInWord > 0)
{
// Beginning with the .NET 4.0 Framework, you
// can use the Increment method to increment
// the counter value by 1. The Increment method
// is safe to use in a multi-threaded
// application.
typingCsInstance.Counters["Words Containing A"].Increment();
typingCsInstance.Counters["Percent of Words Containing A"].Increment();
numberOfLetterAInWord = 0;
}
typingCsInstance.Counters["Percent Base"].Increment();
typingCsInstance.Counters["Total Word Count"].Increment();
typingCsInstance.Counters["Words Typed In Interval"].Increment();
break;
}
}
Açıklamalar
Bu ad alanında sınıflar, Windows Vista'da tanıtılan performans sayaçları için yeni mimariyi (sürüm 2.0) destekler. Yeni mimaride sağlayıcı artık tüketici isteklerine doğrudan yanıt vermiyor, bunun yerine yalnızca sayaç verilerini koruyor. Sistem, sağlayıcı sayaç kümesinin bir örneğini oluşturduğunda sağlayıcının işlemine bir iş parçacığı ekler; iş parçacığı, tüketici isteklerinin işlenmesinden sorumludur.
Aşağıdaki adımlarda sayaç sağlayıcısı yazma işlemi gösterilir.
Sağlayıcının sağladığı sayaçlar XML tabanlı bir bildirimde tanımlanır. Sayaçlar mantıksal olarak sayaç kümelerinde gruplandırılır. Sayaç kümesi içindeki sayaçlar, sayaç kümesi içinde benzersiz olan sayısal bir tanımlayıcıyla tanımlanır. Sağlayıcı bir veya daha fazla sayaç kümesi tanımlayabilir. Bir sayaç kümesi, sağlayıcıya özgü bir Guid ile tanımlanır. Sağlayıcınızı yazmak için bu sınıfları kullanırsanız şunları unutmayın:
Sağlayıcı öğesinin geri çağırma özniteliği yoksayılır.
counterAttribute öğesinin name özniteliği için başvuru değeri yoksayılır.
Bildirimi yazma hakkında ayrıntılı bilgi için bkz. Performans Sayaçları Şeması.
Bildiriminizi yazdıktan sonra, bildirimi (ctrpp provider.man) derlemek için CTRPP aracını kullanın. Araç dört dosya oluşturur: .h, .c, .rc ve *_r.h. .h ve .c dosyalarını yoksayabilirsiniz. .rc dosyası, bildiriminizde tanımlanan yerelleştirilmiş dizeleri içerir. Projenize eklediğiniz derlenmiş kaynak dosyasını (.res) oluşturmak için .rc ve *_r.h dosyalarını kullanırsınız. Aşağıdaki çağrı, kaynak dosyasının nasıl derleneceklerini gösterir:
rc /r /i "c:\Program Files\Microsoft SDKs\Windows\v6.0\Include" provider.rcsal.h dosyasına başvuran bir hata alırsanız, Visual C ekleme dizini olan Microsoft Visual Studio'nuzdaki sal.h dosyasını /i anahtarı için belirttiğiniz dizine kopyalayın.
Derlenmiş kaynak dosyasına (.res) projenizin Uygulama özellik sayfasına bir yol ekleyin.
Sağlayıcınızı yazın. Aşağıdaki adımlar bir sağlayıcı tarafından yapılan çağrıları gösterir:
CounterSet.CounterSet Sayaç kümesini tanımlamak için oluşturucuyu çağırın. Bildirimde tanımlanan her sayaç kümesi için bu yöntemi çağırın.
Her sayaç kümesi için, sayaçları kümeye eklemek için yöntemlerden birini CounterSet.AddCounter çağırın. Sayaç kümesinde tanımlanan her sayaç için bu yöntemi çağırın.
Sayaç kümesinin CounterSet.CreateCounterSetInstance bir örneğini oluşturmak için yöntemini çağırın (örnek, sayaç verilerini içerir). Tek örnekli sayaç kümeleri için bu yöntemi bir kez çağırarak. Birden çok örnek sayaç kümesi için, sayaç verilerini sağlamanız gereken her örnek için bu yöntemi çağırabilirsiniz (her örnek için benzersiz bir ad kullanın).
Sayacın CounterSetInstance.Counters sayaç verilerine erişmek ve bunları ayarlamak için özelliğini kullanın.
Sağlayıcınızı tamamladıktan sonra, bilgisayara sayaçları kaydetmek için LodCtr aracını kullanın. Örneğin,
lodctr /m:provider.manÖrnekte, bildirimin ve yürütülebilir dosyanın geçerli dizinde olduğu varsayılır.
Bu ad alanında bulunan sınıfları Windows Vista ve sonraki işletim sistemlerini çalıştıran bilgisayarlarda kullanabilirsiniz.
