<針對來源的<接聽程式><新增> filter> 元素<>

  • 發行項

將篩選新增至追蹤來源之 Listeners 集合中的接聽項。

<configuration>
  <system.diagnostics>
    <sources>
      <source>
        <listeners>
          <add>
            <filter>

語法

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

屬性和項目

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

屬性

屬性 描述
type 必要屬性。

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

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

子元素

無。

父項目

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

另請參閱