チュートリアル: My.Application.Log の出力の無効化 (Visual Basic)

2011-08-15

このチュートリアルでは、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 による情報の書き込み先の確認 (Visual Basic)」を参照してください。

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>