Share via

<trace> の <listeners> の <add> の <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> 要素は、<sharedListeners> で定義されているリスナーの名前だけでなく、リスナーの種類を指定するトレース リスナーの <add> 要素に格納されている必要があります。 リスナーが <sharedListeners> で定義されている場合は、そのリスナーのフィルターをその要素で定義する必要があります。

この要素は、マシン構成ファイル (Machine.config) とアプリケーション構成ファイルで使用できます。

例

次の例では、<filter> 要素を使用して、フィルター イベント レベルを Error として指定し、トレースの Listeners コレクション内の console リスナーにフィルターを追加する方法を示します。

<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>

関連項目