<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>
関連項目
GitHub で Microsoft と共同作業する
このコンテンツのソースは GitHub にあります。そこで、issue や pull request を作成および確認することもできます。 詳細については、共同作成者ガイドを参照してください。
.NET