<針對追蹤的<<接聽程式><加入>的 filter> 元素>

  • 發行項

將篩選加入至追蹤集合中的 Listeners 接聽程式。

<configuration>
  <system.diagnostics>
    <trace>
      <listeners>
        <add>
          <filter>

語法

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

屬性和項目

下列章節說明屬性、子元素和父元素。

屬性

屬性 描述
type 必要屬性。

指定應該繼承自 TraceFilter 類別的篩選類型。 您可以使用型別的命名空間限定名稱，其對應至類型的 FullName 屬性，也可以使用完整的類型名稱，包括對應至 AssemblyQualifiedName 屬性的元件資訊。 如需完整類型名稱的相關信息，請參閱 指定完整類型名稱。
initializeData 選用屬性。

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

子元素

無。

父項目

元素 描述
configuration 通用語言執行平台和 .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>

另請參閱