System.Diagnostics.PerformanceData 命名空間

參考

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

使用此命名空間中的類別以提供計數器資料。計數器是用來向取用者公開效能指標，例如效能監視器。命名空間未包含取用計數器資料的類別。如需效能計數器架構的完整說明，請參閱效能計數器。

類別

CounterData	包含計數器的未經處理資料 (Raw Data)。
CounterSet	定義一組邏輯計數器。
CounterSetInstance	建立 CounterSet 類別中定義之邏輯計數器的執行個體。
CounterSetInstanceCounterDataSet	包含計數器值的集合。

列舉

CounterSetInstanceType	指定計數器集合可允許多重執行個體 (Instance)，例如處理序 (Process) 和實體磁碟，還是單一執行個體 (例如記憶體)。
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 的錯誤，請從 Microsoft Visual Studio 複製 sal.h 檔案，Visual C include 目錄到您為 /i 參數指定的目錄。

將已編譯資源檔的路徑新增 (.res) 至專案的 [應用程式] 屬性頁。
撰寫您的提供者。下列步驟顯示提供者所進行的呼叫：
1. 呼叫建 CounterSet.CounterSet 構函式以定義計數器集合。針對資訊清單中定義的每個計數器集呼叫這個方法。
2. 針對每個計數器集合，呼叫其中 CounterSet.AddCounter 一個方法，將計數器新增至集合。針對計數器集合中定義的每個計數器呼叫這個方法。
3. CounterSet.CreateCounterSetInstance呼叫方法來建立計數器集的實例， (實例包含計數器資料) 。針對單一實例計數器集合，請呼叫此方法一次。對於多個實例計數器集合，請針對您需要提供計數器資料的每個實例呼叫這個方法， (針對每個實例使用唯一的名稱) 。
4. CounterSetInstance.Counters使用屬性來存取和設定計數器的計數器資料。
完成提供者之後，請使用 LodCtr 工具在電腦上註冊計數器。例如，
```
lodctr /m:provider.man  
```
此範例假設資訊清單和可執行檔位於目前目錄中。

您可以在執行 Windows Vista 和更新版本的作業系統的電腦上，使用此命名空間中的類別。

共用方式為

System.Diagnostics.PerformanceData 命名空間

類別

列舉

範例

備註

其他資源