<source> 的 <listeners> 適用之 <add> 的 <filter> 項目

將篩選條件加入到追蹤來源之 Listeners 集合的接聽項中。

<filter 
  type="traceFilterClassName" 
  initializeData="data" />

屬性和項目

下列各節將說明屬性、子項目和父項目。

屬性

屬性	說明
type	必要屬性。 指定篩選條件的型別，此型別應該繼承自 TraceFilter 類別。 您可使用此型別的符合命名空間之名稱，此名稱會對應到型別的 FullName 屬性，或者可以使用包括組件資訊的完整型別名稱，此名稱會對應到 AssemblyQualifiedName 屬性。 如需完整型別名稱的詳細資訊，請參閱 指定完整的型別名稱。
initializeData	選擇性屬性。 傳遞至指定之篩選類別的建構函式之字串。

子項目

無。

父項目

項目	說明
configuration	Common Language Runtime 和 .NET Framework 應用程式所使用之每個組態檔中的根項目。
system.diagnostics	指定收集、存放和傳送訊息的追蹤接聽程式，以及設定追蹤切換控制的層級。
sources	包含啟始追蹤訊息的追蹤來源。
source	指定啟始追蹤訊息的追蹤來源。
listeners	包含收集、儲存和傳送訊息的接聽程式。 接聽程式將追蹤輸出導向至適當的目標。
add	將接聽項加入到追蹤來源的 Listeners 集合中。

備註

<filter> 項目必須包含在追蹤接聽項的 <add> 項目中，該追踨接聽項不僅指定定義在 <sharedListeners> 項目 中的接聽項名稱，也指定其型別。 如果接聽項定義在 <sharedListeners> 項目 中，則該接聽項的篩選條件必須定義在該項目中。

這個項目可以用於電腦組態檔 (Machine.config) 和應用程式組態檔。

範例

下列範例將示範如何使用 <filter> 項目，在追蹤來源 myTraceSource 的 Listeners 集合中，將篩選條件加入到接聽項 console，並將篩選條件事件層級指定為 Error。

<configuration>
  <system.diagnostics>
    <sources>
      <source name="myTraceSource" switchName="SourceSwitch" 
        switchType="System.Diagnostics.SourceSwitch"  >
        <listeners>
          <add name="console" 
            type="System.Diagnostics.ConsoleTraceListener" >
            <filter type="System.Diagnostics.EventTypeFilter" 
              initializeData="Error" />
          </add>
          <remove name="Default" />
        </listeners>
      </source>
    </sources>
    <switches>
      <add name="SourceSwitch" value="Warning" />
    </switches>
  </system.diagnostics>
</configuration>

請參閱

參考

追蹤和偵錯設定結構描述

TraceSource

TraceListener

TraceListener.Filter

TraceFilter