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

發行項
08/12/2011

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

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

屬性和項目

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

屬性

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

type

必要屬性。

指定篩選條件的型別，此型別應該繼承自 TraceFilter 類別。您可使用此型別的符合命名空間之名稱，此名稱會對應到型別的 FullName 屬性，或者可以使用包括組件資訊的完整型別名稱，此名稱會對應到 AssemblyQualifiedName 屬性。如需完整型別名稱的詳細資訊，請參閱指定完整的型別名稱。

initializeData

選擇性屬性。

傳遞至指定之篩選類別的建構函式之字串。

子項目

無。

父項目

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

備註

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

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

範例

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

<configuration>
  <system.diagnostics>
    <trace autoflush="false" indentsize="4">
      <listeners>
        <add name="console" 
          type="System.Diagnostics.ConsoleTraceListener" >
          <filter type="System.Diagnostics.EventTypeFilter" 
            initializeData="Error" />
        </add>
        <remove name="Default" />
      </listeners>
    </trace>
  </system.diagnostics>
</configuration>