<add> for <sharedListeners 的 <filter> 元素>

  • 發行項

將篩選新增至 sharedListeners 集合中的接聽項。

<configuration>
  <system.diagnostics>
    <sharedListeners>
      <add>
        <filter>

語法

<filter type="System.Diagnostics.EventTypeFilter"
  initializeData="Warning" />

屬性和項目

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

屬性

屬性 描述
type 必要的 屬性。

指定篩選的類型。 您只能使用型別的完整名稱（以 屬性的格式 Type.FullName ），也可以使用完整的類型名稱，包括元件資訊（以 屬性的格式 Type.AssemblyQualifiedName ）。 如需建立完整類型名稱的資訊，請參閱 指定完整類型名稱。
initializeData 選用屬性。

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

子元素

無。

父項目

元素 描述
configuration 通用語言執行平台和 .NET Framework 應用程式所使用之每個組態檔中的根項目。
system.diagnostics 指定用於收集、儲存及路由傳送訊息的追蹤接聽項，以及設定追蹤參數的層級。
sharedListeners 任何來源或追蹤專案都可以參考的接聽程式集合。
add 將接聽程式新增至 sharedListeners 集合。

備註

如果接聽程式是在 元素的 <sharedListeners> 元素中<add>定義，則該接聽程式的篩選應該定義在專案子系的專案<add>中<filter>。

這個元素可用於計算機組態檔 （Machine.config） 和應用程式組態檔。

範例

下列範例示範如何使用 <filter> 元素，將篩選新增至集合中的sharedListeners追蹤接聽程式console。

<configuration>  
  <system.diagnostics>  
    <sources>  
      <source name="myTraceSource" >  
        <listeners>  
          <add name="console" />  
          <remove name="Default" />  
        </listeners>  
      </source>  
    </sources>  
    <sharedListeners>  
      <add name="console"
        type="System.Diagnostics.ConsoleTraceListener" >  
        <filter type="System.Diagnostics.EventTypeFilter"
          initializeData="Error" />  
      </add>  
    </sharedListeners>  
  </system.diagnostics>  
</configuration>

另請參閱