System.Diagnostics.PerformanceData 命名空间
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
使用此命名空间中的类来提供计数器数据。 计数器用于向用户公开性能指标，如性能监视器。 命名空间不包含用于使用计数器数据的类。 有关性能计数器体系结构的完整说明，请参阅性能计数器。
类
| CounterData |
包含计数器的原始数据。 |
| CounterSet |
定义一组逻辑计数器。 |
| CounterSetInstance |
创建在 CounterSet 类中定义的逻辑计数器的实例。 |
| CounterSetInstanceCounterDataSet |
包含计数器值的集合。 |
枚举
| CounterSetInstanceType |
指定计数器集是允许多实例（如进程和物理磁盘），还是允许单实例（如内存）。 |
| CounterType |
定义可能的计数器类型。 每个计数器都被分配一个计数器类型。 计数器类型用来确定如何计算和显示计数器数据以及如何对其求平均值。 |
示例
下面显示了一个简单的清单：
<!-- <?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>
下面显示了清单的简单提供程序实现：
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;
}
}
注解
此命名空间中的类支持 Windows Vista 中引入的性能计数器的新体系结构 (2.0) 版本。 在新体系结构中，提供程序不再直接响应使用者请求，而只是维护计数器数据。 当提供程序创建计数器集的实例时，系统会将线程注入提供程序的进程;线程负责处理使用者请求。
以下步骤演示了编写计数器提供程序的过程。
提供程序提供的计数器在基于 XML 的清单中定义。 计数器按逻辑分组到计数器集中。 计数器集中的计数器由计数器集中唯一的数字标识符标识。 提供程序可以定义一个或多个计数器集。 计数器集由提供程序唯一的 Guid 标识。 请注意，如果使用这些类来编写提供程序：
将忽略提供程序元素的回调属性。
将忽略 counterAttribute 元素的 name 属性的引用值。
有关编写清单的详细信息，请参阅 性能计数器架构。
编写清单后，使用 CTRPP 工具 (ctrpp provider.man) 编译清单。 该工具生成四个文件：.h、.c、.rc 和 *_r.h。 可以忽略 .h 和 .c 文件。 .rc 文件包含清单中定义的本地化字符串。 使用 .rc 和 *_r.h 文件创建包含在项目中的已编译资源文件 (.res) 。 以下调用演示如何编译资源文件：
rc /r /i "c:\Program Files\Microsoft SDKs\Windows\v6.0\Include" provider.rc如果收到引用 sal.h 的错误，请将 sal.h 文件从 Microsoft Visual Studio，Visual C include 目录复制到为 /i 开关指定的目录。
将编译的资源文件 (.res) 的路径添加到项目的“应用程序”属性页。
编写提供程序。 以下步骤显示了提供程序进行的调用：
CounterSet.CounterSet调用构造函数以定义计数器集。 对清单中定义的每个计数器集调用此方法。
对于每个计数器集，调用其中 CounterSet.AddCounter 一种方法将计数器添加到该集。 对计数器集中定义的每个计数器调用此方法。
CounterSet.CreateCounterSetInstance调用 方法以创建计数器集的实例， (实例包含计数器数据) 。 对于单实例计数器集，请调用此方法一次。 对于多个实例计数器集，请为需要提供计数器数据的每个实例调用此方法， (为每个实例) 使用唯一名称。
CounterSetInstance.Counters使用 属性访问和设置计数器的计数器数据。
完成提供程序后，使用 LodCtr 工具在计算机上注册计数器。 例如，
lodctr /m:provider.man该示例假定清单和可执行文件位于当前目录中。
可以在运行 Windows Vista 和更高版本的操作系统的计算机上使用此命名空间中的类。
