チュートリアル : My.Application.Log の出力をオフにする

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

このチュートリアルでは、My.Application.Log オブジェクトの既定のログフィルタ処理をオフにする方法を説明します。構成情報はアプリケーションの構成ファイルに格納されているため、ログの動作は、アプリケーションをビルドした後でも変更できます。

概要

My.Application.Log オブジェクトは、自らが取得した各メッセージをログリスナに渡します。このサンプルアプリケーションでは、My.Application.Log.WriteEntry メソッドを使用して、リスナにメッセージを書き込みます。

サンプルアプリケーションをビルドするには

新しい Visual Basic Windows アプリケーションプロジェクトを開きます。
Button1 という名前のボタンを Form1 に追加します。
Button1 の Click イベントハンドラに次のコードを追加します。
```
My.Application.Log.WriteEntry("Log entry")
```
アプリケーションをデバッガで実行します。
Button1 をクリックします。

アプリケーションのデバッグ出力およびログファイルに次の情報が書き込まれます。

DefaultSource Information: 0 : Log entry
アプリケーションを閉じます。

アプリケーションのデバッグ出力ウィンドウを表示する方法については、「[出力] ウィンドウ」を参照してください。アプリケーションのログファイルの場所については、「チュートリアル : My.Application.Log による情報の書き込み先の確認」を参照してください。

My.Application.Log からのリスナの削除

既定では、アプリケーションには、アプリケーションのデバッグ出力に書き込むリスナとログファイルに書き込むリスナの 2 つがあります。この例では、それらのリスナを削除する方法を説明します。

Log オブジェクトからログリスナを削除するには

ソリューションエクスプローラで app.config を右クリックし、[開く] をクリックします。

または

app.config ファイルがない場合は、次の操作を行います。
1. [プロジェクト] メニューの [新しい項目の追加] をクリックします。
2. [新しい項目の追加] ボックスで、[アプリケーション構成ファイル] をクリックします。
3. [追加] をクリックします。
name 属性が "DefaultSource". の <source> セクションで、<listeners> セクションを見つけます。

これらのログ構成セクションは、構成ファイルのメインの <configuration> ノードの <system.diagnostics> ノードにあります。DefaultSource の XML は <sources> ノードにあります。
"FileLog" という name 属性を持つ <add> 要素を削除します。次のような要素です。

<add name="FileLog"/>

<listeners> セクションに次の要素を追加します。

<!-- Remove the default debug listener. -->
<remove name="Default"/>

app.config ファイルの内容は次の XML のようになります。

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
  <system.diagnostics>
    <sources>
      <!-- This section configures My.Application.Log -->
      <source name="DefaultSource" switchName="DefaultSwitch">
        <listeners>
          <!-- Remove the default debug listener. -->
          <remove name="Default"/>
        </listeners>
      </source>
    </sources>
    <switches>
      <add name="DefaultSwitch" value="Information" />
    </switches>
  </system.diagnostics>
</configuration>