<sharedListeners> 適用之 <add> 的 <filter> 項目

發行項
08/21/2008

更新：2007 年 11 月

將篩選條件加入到 sharedListeners 集合中的接聽項。

<configuration> 項目
   <system.diagnostics> 項目
     <sharedListeners> 項目
       <sharedListeners> 的 <add> 項目
         <sharedListeners> 適用之 <add> 的 <filter> 項目

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

屬性和項目

下列章節會說明屬性 (Attribute)、子項目和父項目。

屬性

屬性	說明
型別	必要的屬性。指定篩選條件的型別。您只能使用此型別的完整名稱 (使用 Type.FullName 屬性的格式)，或者可以使用包括此組件資訊的完整型別名稱 (使用 Type.AssemblyQualifiedName 屬性的格式)。如需建立完整型別名稱的詳細資訊，請參閱指定完整的型別名稱。
initializeData	選擇性屬性。傳遞至指定類別的建構函式的字串。

型別

必要的屬性。

指定篩選條件的型別。您只能使用此型別的完整名稱 (使用 Type.FullName 屬性的格式)，或者可以使用包括此組件資訊的完整型別名稱 (使用 Type.AssemblyQualifiedName 屬性的格式)。如需建立完整型別名稱的詳細資訊，請參閱指定完整的型別名稱。

initializeData

選擇性屬性。

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

子項目

無

父項目

項目	描述
configuration	Common Language Runtime 和 .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>