方法 : TraceSource とフィルターをトレースリスナーと共に使用する

[アーティクル]
08/09/2011

.NET Framework Version 2.0 の新機能の 1 つが拡張されたトレースシステムです。基本的な前提は変わっていません。つまり、トレースメッセージはスイッチを介してリスナーに送信され、リスナーは関連付けられている出力媒体にデータを報告します。 Version 2.0 の前バージョンとの大きな違いは、トレースが TraceSource クラスのインスタンスを使用して開始できるという点です。 TraceSource は拡張されたトレースシステムとして機能するためのもので、以前の Trace トレースクラスと Debug トレースクラスの静的メソッドの代わりに使用できます。前バージョンの Trace クラスと Debug クラスも引き続き使用できますが、トレースには TraceSource クラスを使用することをお勧めします。

ここでは、アプリケーション構成ファイルと合わせて TraceSource を使用する方法について説明します。トレースは、構成ファイルを使用せずに TraceSource のみを使用して実行することもできますが、お勧めできません。構成ファイルを使用しないトレースについては、「方法: トレースソースを作成し初期化する」を参照してください。

トレースソースを作成および初期化するには

アプリケーションにトレース機能をインストルメントするには、最初にトレースソースを作成します。さまざまなコンポーネントを含む大型のプロジェクトでは、コンポーネントごとに別個のトレースソースを作成できます。トレースソースの名前には、アプリケーション名を使用することをお勧めします。これにより、個々のトレースを別々に維持することが容易になります。次のコードでは、新しいトレースソース (mySource) を作成し、イベントをトレースするメソッド (Activity1) を呼び出します。トレースメッセージは、既定のトレースリスナーによって書き込まれます。
```
using System;
using System.Diagnostics;
using System.Threading;

namespace TraceSourceApp
{
    class Program
    {
        private static TraceSource mySource = 
            new TraceSource("TraceSourceApp");
        static void Main(string[] args)
        {
            Activity1();
            mySource.Close();
            return;
        }
        static void Activity1()
        {
            mySource.TraceEvent(TraceEventType.Error, 1, 
                "Error message.");
            mySource.TraceEvent(TraceEventType.Warning, 2, 
                "Warning message.");
        }
    }
}
```

トレースリスナーとフィルターを作成および初期化するには

最初のプロシージャのコードは、トレースリスナーとフィルターをプログラムによって識別しません。このコードでは、単にトレースメッセージが既定のトレースリスナーに書き込まれるだけです。特定のトレースリスナーとその関連フィルターを設定するには、アプリケーションの名前に対応する構成ファイルを編集します。このファイルでは、リスナーを追加または削除したり、リスナーのプロパティとフィルターを設定したりできます。また、複数のリスナーを削除することもできます。前のプロシージャで作成したトレースソースに対するコンソールトレースリスナーとテキストライタートレースリスナーを初期化する方法を次の構成ファイルの例に示します。この構成ファイルは、トレースリスナーを設定するだけでなく、両方のリスナーについてフィルターを作成し、トレースソースのソーススイッチも作成します。トレースリスナーを追加する 2 つの方法が示されています。1 つは、リスナーをトレースソースに直接追加する方法で、もう 1 つは、リスナーを共有リスナーコレクションに追加したうえで、名前でリスナーをトレースソースに追加する方法です。 2 つのリスナーに対して識別されたフィルターは、異なるソースレベルで初期化されます。この結果、一部のメッセージが 2 つのリスナーのいずれか一方のみによって書き込まれます。
```
<configuration>
  <system.diagnostics>
    <sources>
      <source name="TraceSourceApp" 
        switchName="sourceSwitch" 
        switchType="System.Diagnostics.SourceSwitch">
        <listeners>
          <add name="console" 
            type="System.Diagnostics.ConsoleTraceListener">
            <filter type="System.Diagnostics.EventTypeFilter" 
              initializeData="Warning"/>
          </add>
          <add name="myListener"/>
          <remove name="Default"/>
        </listeners>
      </source>
    </sources>
    <switches>
      <add name="sourceSwitch" value="Warning"/>
    </switches>
    <sharedListeners>
      <add name="myListener" 
        type="System.Diagnostics.TextWriterTraceListener" 
        initializeData="myListener.log">
        <filter type="System.Diagnostics.EventTypeFilter" 
          initializeData="Error"/>
      </add>
    </sharedListeners>
  </system.diagnostics>
</configuration>
```

リスナーがトレースメッセージを書き込むレベルを変更するには

構成ファイルは、アプリケーションが初期化されるときにトレースソースの設定を初期化します。この設定を変更するには、構成ファイルを変更し、アプリケーションを再起動するか、または Trace.Refresh メソッドを使用して、プログラムによってアプリケーションを更新する必要があります。アプリケーションは、構成ファイルによって設定されたプロパティを動的に変更し、ユーザーによって指定された設定値をオーバーライドできます。たとえば、現在の構成設定とは関係なく、警告メッセージが常にテキストファイルに送られるようにすることもできます。

using System;
using System.Diagnostics;
using System.Threading;

namespace TraceSourceApp
{
    class Program
    {
        private static TraceSource mySource = 
            new TraceSource("TraceSourceApp");
        static void Main(string[] args)
        {
            Activity1();

            // Change the event type for which tracing occurs.
            // The console trace listener must be specified 
            // in the configuration file. First, save the original
            // settings from the configuration file.
            EventTypeFilter configFilter = 
                (EventTypeFilter)mySource.Listeners["console"].Filter;

            // Then create a new event type filter that ensures 
            // critical messages will be written.
            mySource.Listeners["console"].Filter =
                new EventTypeFilter(SourceLevels.Critical);
            Activity2();

            // Allow the trace source to send messages to listeners 
            // for all event types. This statement will override 
            // any settings in the configuration file.
            mySource.Switch.Level = SourceLevels.All;

            // Restore the original filter settings.
            mySource.Listeners["console"].Filter = configFilter;
            Activity3();
            mySource.Close();
            return;
        }
        static void Activity1()
        {
            mySource.TraceEvent(TraceEventType.Error, 1, 
                "Error message.");
            mySource.TraceEvent(TraceEventType.Warning, 2, 
                "Warning message.");
        }
        static void Activity2()
        {
            mySource.TraceEvent(TraceEventType.Critical, 3, 
                "Critical message.");
            mySource.TraceInformation("Informational message.");
        }
        static void Activity3()
        {
            mySource.TraceEvent(TraceEventType.Error, 4, 
                "Error message.");
            mySource.TraceInformation("Informational message.");
        }
    }
}

参照

次の方法で共有

方法 : TraceSource とフィルターをトレースリスナーと共に使用する

トレースソースを作成および初期化するには

トレースリスナーとフィルターを作成および初期化するには

リスナーがトレースメッセージを書き込むレベルを変更するには

参照

処理手順

参照

概念

その他のリソース

次の方法で共有

方法 : TraceSource とフィルターをトレース リスナーと共に使用する

トレース ソースを作成および初期化するには

トレース リスナーとフィルターを作成および初期化するには

リスナーがトレース メッセージを書き込むレベルを変更するには

参照

処理手順

参照

概念

その他のリソース

方法 : TraceSource とフィルターをトレースリスナーと共に使用する

トレースソースを作成および初期化するには

トレースリスナーとフィルターを作成および初期化するには

リスナーがトレースメッセージを書き込むレベルを変更するには