TraceListener.Filter プロパティとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

TraceListener.Filter プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

トレースリスナのトレースフィルタを取得および設定します。

名前空間: System.Diagnostics
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

<ComVisibleAttribute(False)> _
Public Property Filter As
 TraceFilter

Visual Basic (使用法)

Dim instance As TraceListener
Dim value As TraceFilter

value = instance.Filter

instance.Filter = value

[ComVisibleAttribute(false)] 
public TraceFilter Filter { get; set;
 }

C++

[ComVisibleAttribute(false)] 
public:
property TraceFilter^ Filter {
    TraceFilter^ get ();
    void set (TraceFilter^ value);
}

/** @property */
public TraceFilter get_Filter ()

/** @property */
public void set_Filter (TraceFilter value)

JScript

public function get Filter
 () : TraceFilter

public function set Filter
 (value : TraceFilter)

プロパティ値
TraceFilter 基本クラスから派生したオブジェクト。

解説

トレースフィルタをトレースリスナに追加することにより、スイッチがトレースソースに提供する層に加えて、スクリーニングの層を提供できます。たとえば、EventTypeFilter をトレースリスナに追加して、リスナが出力するイベントタイプを制御できます。スイッチの条件が一致したために呼び出されたリスナは、フィルタがあればフィルタに照会して、トレースが出力に送られるかどうかを判断できます。

使用例

Filter プロパティを使用してソースフィルタをコンソールトレースリスナに追加する方法を次のコード例に示します。このコード例は、TraceSource クラスのトピックで取り上げているコード例の一部分です。

Visual Basic

' Test the filter on the ConsoleTraceListener.
ts.Listeners("console").Filter = New
 SourceFilter("No match")
ts.TraceData(TraceEventType.Error, 5, "SourceFilter should reject
 this message for the console trace listener.")
ts.Listeners("console").Filter = New
 SourceFilter("TraceTest")
ts.TraceData(TraceEventType.Error, 6, "SourceFilter should let
 this message through on the console trace listener.")

// Test the filter on the ConsoleTraceListener.
ts.Listeners["console"].Filter = new SourceFilter("No
 match");
ts.TraceData(TraceEventType.Error, 5,
    "SourceFilter should reject this message for
 the console trace listener.");
ts.Listeners["console"].Filter = new SourceFilter("TraceTest");
ts.TraceData(TraceEventType.Error, 6,
    "SourceFilter should let this message through on the
 console trace listener.");