System.Diagnostics 命名空間

提供類別，可讓您與系統進程、事件記錄檔和性能計數器互動。

類別

Activity	表示具有要用於記錄之內容的作業。
ActivityListener	允許接聽開始和停止活動事件，並有機會決定建立取樣案例的活動。
ActivitySource	提供 API 來建立和啟動 Activity 物件，以及註冊 ActivityListener 物件來接聽 Activity 事件。
ActivityTagsCollection	ActivityTagsCollection 是用來儲存追蹤標記的集合類別。 此集合將搭配 ActivityEvent 和 ActivityLink等類別使用。 此集合的行為如下： 集合項目會根據其新增方式來排序。 不允許使用相同的索引鍵重複專案。 使用索引器將項目儲存在集合中時： 如果專案具有先前存在於集合中的索引鍵，且值為 null，則會從集合中移除符合索引鍵的集合專案。 如果專案具有先前存在於集合中的索引鍵，且值不是 null，則新專案值會取代儲存在集合中的舊值。 否則，專案將會加入至集合。 如果專案還沒有具有相同索引鍵的專案，Add 方法就會將新專案新增至集合。 否則，它會擲回例外狀況。
BooleanSwitch	提供控制偵錯和追蹤輸出的簡單開啟/關閉開關。
ConditionalAttribute	指示編譯程式，除非定義指定的條件式編譯符號，否則應該忽略方法呼叫或屬性。
ConsoleTraceListener	將追蹤或偵錯輸出導向至標準輸出或標準錯誤數據流。
CorrelationManager	將屬於邏輯交易一部分的追蹤相互關聯。
CounterCreationData	定義自定義計數器的計數器類型、名稱和說明字串。
CounterCreationDataCollection	提供 CounterCreationData 對象的強型別集合。
CounterSampleCalculator	提供一組公用程式函式來解譯性能計數器數據。
DataReceivedEventArgs	提供 OutputDataReceived 和 ErrorDataReceived 事件的數據。
Debug	提供一組可協助偵錯程序代碼的方法和屬性。
DebuggableAttribute	修改運行時間 Just-In-Time 偵錯的程式代碼產生。 無法繼承這個類別。
Debugger	啟用與調試程序的通訊。 無法繼承這個類別。
DebuggerBrowsableAttribute	判斷成員是否及如何顯示在調試程式變數視窗中。 無法繼承這個類別。
DebuggerDisplayAttribute	決定類別或欄位在調試程式變數視窗中的顯示方式。
DebuggerHiddenAttribute	指定 DebuggerHiddenAttribute。 無法繼承這個類別。
DebuggerNonUserCodeAttribute	識別不是應用程式用戶程序代碼一部分的類型或成員。
DebuggerStepperBoundaryAttribute	指出下列屬性的程式代碼是在執行中執行，而不是步驟、模式。
DebuggerStepThroughAttribute	指示調試程式逐步執行程序代碼，而不是逐步執行程序代碼。 無法繼承這個類別。
DebuggerTypeProxyAttribute	指定類型的顯示 Proxy。
DebuggerVisualizerAttribute	指定類型具有可視化檢視。 無法繼承這個類別。
DefaultTraceListener	提供追蹤的預設輸出方法和行為。
DelimitedListTraceListener	將追蹤或偵錯輸出導向至文字寫入器，例如數據流寫入器或數據流，例如檔案數據流。
DiagnosticListener	提供抽象 DiagnosticSource 類別的實作，代表來源傳送其資訊之具名位置（events）。
DiagnosticSource	抽象類，可讓程式代碼進行檢測，以記錄豐富數據承載的生產時間記錄，以在已檢測的程式內取用。
DistributedContextPropagator	DistributedContextPropagator 的實作會決定在周遊網路時，分散式內容信息的編碼和譯碼方式。 編碼可以透過任何支援字串索引鍵/值組的網路通訊協定傳輸。 例如，使用 HTTP 時，每個機碼/值組都是 HTTP 標頭。 DistributedContextPropagator 將值插入並擷取來自電信業者的值做為字串索引鍵/值組。
EntryWrittenEventArgs	提供 EntryWritten 事件的數據。
EventInstance	表示事件記錄檔項目的語言中性資訊。
EventLog	提供與 Windows 事件記錄檔的互動。
EventLogEntry	封裝事件記錄檔中的單一記錄。 無法繼承這個類別。
EventLogEntryCollection	定義 EventLogEntry 實例集合的大小和列舉值。
EventLogPermission	控制事件記錄的程式代碼訪問許可權。
EventLogPermissionAttribute	允許宣告式許可權檢查事件記錄。
EventLogPermissionEntry	定義為 EventLog設定之代碼存取安全性許可權的最小單位。
EventLogPermissionEntryCollection	包含 EventLogPermissionEntry 對象的強型別集合。
EventLogTraceListener	提供簡單的接聽程式，將追蹤或偵錯輸出導向至 EventLog。
EventSourceCreationData	表示用來在本機電腦或遠端電腦上建立事件記錄檔來源的組態設定。
EventTypeFilter	指出接聽程式是否應該根據事件類型進行追蹤。
FileVersionInfo	提供磁碟上實體檔案的版本資訊。
InitializingSwitchEventArgs	提供 Switch.Initializing 事件的數據。
InitializingTraceSourceEventArgs	提供 TraceSource.Initializing 事件的數據。
InstanceData	保存與性能計數器範例相關聯的實例數據。
InstanceDataCollection	提供 InstanceData 對象的強型別集合。
InstanceDataCollectionCollection	提供 InstanceDataCollection 對象的強型別集合。
MonitoringDescriptionAttribute	指定屬性或事件的描述。
PerformanceCounter	表示 Windows NT 性能計數器元件。
PerformanceCounterCategory	表示性能對象，這個物件會定義性能計數器的類別。
PerformanceCounterManager	使用性能計數器時，為系統載入 performance.dll 準備效能數據。
PerformanceCounterPermission	允許控制 PerformanceCounter的程式代碼訪問許可權。
PerformanceCounterPermissionAttribute	允許宣告式性能計數器許可權檢查。
PerformanceCounterPermissionEntry	定義為 PerformanceCounter設定之代碼存取安全性許可權的最小單位。
PerformanceCounterPermissionEntryCollection	包含 PerformanceCounterPermissionEntry 對象的強型別集合。
Process	提供本機和遠端進程的存取權，並可讓您啟動和停止本機系統進程。
ProcessModule	表示載入至特定進程的 .dll 或 .exe 檔案。
ProcessModuleCollection	提供 ProcessModule 對象的強型別集合。
ProcessStartInfo	指定啟動進程時所使用的一組值。
ProcessThread	表示操作系統進程線程。
ProcessThreadCollection	提供 ProcessThread 對象的強型別集合。
SourceFilter	指出接聽程式是否應該根據追蹤的來源追蹤訊息。
SourceSwitch	提供多層級參數來控制追蹤和偵錯輸出，而不需重新編譯程序代碼。
StackFrame	提供 StackFrame的相關信息，代表目前線程之呼叫堆棧上的函式呼叫。
StackFrameExtensions	提供 StackFrame 類別的擴充方法，代表目前線程之呼叫堆疊上的函式呼叫。
StackTrace	表示堆棧追蹤，這是一或多個堆疊框架的已排序集合。
StackTraceHiddenAttribute	使用 StackTraceHidden 屬性的類型和方法，將會從 StackTrace.ToString（） 和 Exception.StackTrace 中顯示的堆棧追蹤文字中省略
Stopwatch	提供一組方法與屬性，可讓您用來精確測量經過的時間。
Switch	提供抽象基類，以建立新的偵錯和追蹤參數。
SwitchAttribute	識別元件、類別或成員中使用的參數。
SwitchLevelAttribute	識別參數的層級類型。
TextWriterTraceListener	將追蹤或偵錯輸出導向 TextWriter 或 Stream，例如 FileStream。
Trace	提供一組方法和屬性，協助您追蹤程式代碼的執行。 無法繼承這個類別。
TraceConfiguration	提供類別，可讓您與系統進程、事件記錄檔和性能計數器互動。
TraceEventCache	提供線程和進程特有的追蹤事件數據。
TraceFilter	提供追蹤篩選實作的基類。
TraceListener	為監視追蹤和偵錯輸出的接聽程式提供 abstract 基類。
TraceListenerCollection	提供 TraceListener 對象的線程安全清單。
TraceSource	提供一組方法和屬性，讓應用程式能夠追蹤程式代碼的執行，並將追蹤訊息與其來源產生關聯。
TraceSwitch	提供多層級參數來控制追蹤和偵錯輸出，而不需重新編譯程序代碼。
UnreachableException	當程式執行被認為無法連線的指令時所擲回的例外狀況。
XmlWriterTraceListener	將追蹤或偵錯輸出當做 XML 編碼的數據導向 TextWriter 或 Stream，例如 FileStream。

結構

Activity.Enumerator<T>	列舉儲存在 Activity 對象上的數據。
ActivityChangedEventArgs	提供 CurrentChanged 事件的數據。
ActivityContext	符合 W3C TraceContext 規格的表示法。 它包含兩個標識碼：TraceId 和 SpanId，以及一組常見的 TraceFlags 和系統特定的 TraceState 值。
ActivityCreationOptions<T>	封裝傳送給活動接聽程式的所有資訊，以決定建立活動實例及其狀態。 可能的泛型型別參數 ActivityContext 或 String。
ActivityEvent	表示包含名稱和時間戳的事件，以及選擇性的標記清單。
ActivityLink	活動可能會連結到因果相關之零個或多個活動內容實例。 活動連結可以指向單一追蹤或跨不同追蹤的活動內容。 活動連結可用來代表由多個起始活動起始活動的批次作業，每個作業都代表批次中正在處理的單一傳入專案。
ActivitySpanId	表示以 W3C 標準格式化的 SpanId。
ActivityTagsCollection.Enumerator	列舉 ActivityTagsCollection的專案。
ActivityTraceId	表示格式是以 W3C 標準為基礎的 TraceId。
CounterSample	定義結構，此結構會保存性能計數器的原始數據。
Debug.AssertInterpolatedStringHandler	提供 Assert(Boolean) 的插補字串處理程式，只有在判斷提示失敗時才會執行格式設定。
Debug.WriteIfInterpolatedStringHandler	提供 WriteIf(Boolean, String) 和 WriteLineIf(Boolean, Object) 的插補字串處理程式，只有在套用條件時才會執行格式設定。
TagList	表示可依索引存取的標記清單。 提供搜尋、排序及操作清單的方法。
TagList.Enumerator	周遊標籤標清單集合的列舉值。

介面

ICollectData

使用性能計數器時，為系統載入的效能 DLL 準備效能數據。

列舉

ActivityIdFormat	指定 Id 屬性的格式。
ActivityKind	描述活動、其父系和追蹤中的子系之間的關聯性。
ActivitySamplingResult	ActivityListener 所使用的列舉值，表示要針對相關 Activity收集的數據量。 要求更多數據會造成更高的效能額外負荷。
ActivityStatusCode	定義活動的狀態代碼，指出已檢測作業的狀態。
ActivityTraceFlags	指定由與活動相關聯的 W3C 標準所定義的旗標。
DebuggableAttribute.DebuggingModes	指定 Just-In-Time 編譯程式的偵錯模式。
DebuggerBrowsableState	提供調試程序的顯示指示。
EventLogEntryType	指定事件記錄檔專案的事件類型。
EventLogPermissionAccess	定義 EventLog 許可權類別所使用的存取層級。
OverflowAction	指定如何處理事件記錄檔中已達到其檔案大小上限的專案。
PerformanceCounterCategoryType	指出性能計數器類別是否可以有多個實例。
PerformanceCounterInstanceLifetime	指定性能計數器實例的存留期。
PerformanceCounterPermissionAccess	定義 PerformanceCounter 許可權類別所使用的存取層級。
PerformanceCounterType	指定直接對應至原生類型的性能計數器類型。
ProcessPriorityClass	指出系統與進程建立關聯的優先順序。 這個值與進程每個線程的優先順序值一起，決定每個線程的基底優先順序層級。
ProcessWindowStyle	指定當系統啟動進程時，新視窗應該如何出現。
SourceLevels	指定來源參數和事件類型篩選所篩選的追蹤訊息層級。
ThreadPriorityLevel	指定線程的優先順序層級。
ThreadState	指定線程的目前執行狀態。
ThreadWaitReason	指定線程正在等候的原因。
TraceEventType	識別造成追蹤的事件類型。
TraceLevel	指定要輸出 Debug、Trace 和 TraceSwitch 類別的訊息。
TraceOptions	指定要寫入追蹤輸出的追蹤資料選項。

委派

DataReceivedEventHandler	表示將處理 Process之 OutputDataReceived 事件或 ErrorDataReceived 事件的方法。
DistributedContextPropagator.PropagatorGetterCallback	表示在傳播器的擷取方法中使用的回呼方法。 叫用回呼來查閱具名字段的值。
DistributedContextPropagator.PropagatorSetterCallback	表示在傳播器插入方法中使用的回呼方法。 叫用這個回呼來設定具名字段的值。 傳播者可以多次叫用它，以設定多個字段。
EntryWrittenEventHandler	表示將處理 EventLog之 EntryWritten 事件的方法。
ExceptionRecorder	提供類別，可讓您與系統進程、事件記錄檔和性能計數器互動。
SampleActivity<T>	委派，定義取樣程式中使用的 ActivityListener 回呼簽章。

備註

• EventLog 元件提供寫入事件記錄檔、讀取事件記錄專案，以及在網路上建立和刪除事件記錄檔和事件來源的功能。 EntryWrittenEventHandler 提供一種方式，以異步方式與事件記錄檔互動。 支持類別提供更詳細控件的存取權，包括：許可權限制、指定事件記錄檔類型的能力（控制以事件記錄檔專案寫入的預設數據類型），以及逐一查看事件記錄專案集合。 如需這些工作的詳細資訊，請參閱 EventLogPermission、EventLogEntryType和 EventLogEntryCollection 類別。

• Process 類別提供功能來監視整個網路的系統進程，以及啟動和停止本機系統進程。 除了擷取執行中進程的清單（藉由指定計算機、進程名稱或進程標識元），或檢視目前可存取處理器的進程相關信息，您還可以透過 Process 類別本身取得進程線程和模組的詳細知識，以及與 ProcessThread 和 ProcessModule 類別互動。 ProcessStartInfo 類別可讓您指定要啟動新進程的各種元素，例如輸入、輸出和錯誤數據流、工作目錄，以及命令行動詞和自變數。 這些可讓您精細控制進程的行為。 其他相關類別可讓您指定視窗樣式、進程和線程優先順序，並與線程和模組的集合互動。

• PerformanceCounter 類別可讓您監視系統效能，而 PerformanceCounterCategory 類別則提供建立新自定義計數器和類別的方法。 您可以寫入本機自定義計數器，並從本機和遠端計數器讀取（系統和自定義）。 您可以使用 PerformanceCounter 類別取樣計數器，並使用 CounterSample 類別計算後續性能計數器樣本的結果。 CounterCreationData 類別可讓您在類別中建立多個計數器，並指定其類型。 與性能計數器元件相關聯的其他類別提供計數器集合、計數器許可權和計數器類型的存取權。

System.Diagnostics 命名空間也提供類別，可讓您對應用程式進行偵錯，並追蹤程式代碼的執行。 如需詳細資訊，請參閱 Trace 和 Debug 類別。