チュートリアル: My.Application.Log による情報の書き込み先の変更 (Visual Basic)

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

My.Application.Log オブジェクトおよび My.Log オブジェクトを使用すると、アプリケーション内で発生したイベントに関する情報をログに記録できます。このチュートリアルでは、既定の設定をオーバーライドして、Log オブジェクトによる書き込み先を他のログリスナーに変更する方法を示します。

必須コンポーネント

Log オブジェクトは、複数のログリスナーに情報を書き込むことができます。ログリスナーの構成を変更する前に、現在の構成を確認する必要があります。詳細については、「チュートリアル: My.Application.Log による情報の書き込み先の確認 (Visual Basic)」を参照してください。

必要に応じて、「方法: イベント情報をテキストファイルに書き込む (Visual Basic)」および「方法: アプリケーションイベントログに書き込む (Visual Basic)」も参照してください。

リスナーを追加するには

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

または

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

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

<!-- Uncomment to connect the application file log. -->
<!-- <add name="FileLog" /> -->
<!-- Uncomment to connect the event log. -->
<!-- <add name="EventLog" /> -->
<!-- Uncomment to connect the event log. -->
<!-- <add name="Delimited" /> -->
<!-- Uncomment to connect the XML log. -->
<!-- <add name="XmlWriter" /> -->
<!-- Uncomment to connect the console log. -->
<!-- <add name="Console" /> -->

Log のメッセージを受け取らせるログリスナーをコメントから外します。
最上位の <configuration> セクション内の <system.diagnostics> セクションで、<sharedListeners> セクションを見つけます。

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

      <add name="FileLog"
           type="Microsoft.VisualBasic.Logging.FileLogTraceListener, 
                 Microsoft.VisualBasic, Version=8.0.0.0, 
                 Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a"
           initializeData="FileLogWriter" />
      <add name="EventLog"
           type="System.Diagnostics.EventLogTraceListener, 
                 System, Version=2.0.0.0, 
                 Culture=neutral, PublicKeyToken=b77a5c561934e089"
           initializeData="sample application"/>
      <add name="Delimited" 
           type="System.Diagnostics.DelimitedListTraceListener, 
                 System, Version=2.0.0.0, 
                 Culture=neutral, PublicKeyToken=b77a5c561934e089"
           initializeData="c:\temp\sampleDelimitedFile.txt"
           traceOutputOptions="DateTime" />
      <add name="XmlWriter"
           type="System.Diagnostics.XmlWriterTraceListener, 
                 System, Version=2.0.0.0, 
                 Culture=neutral, PublicKeyToken=b77a5c561934e089"
           initializeData="c:\temp\sampleLogFile.xml" />
      <add name="Console"
           type="System.Diagnostics.ConsoleTraceListener, 
                 System, Version=2.0.0.0, 
                 Culture=neutral, PublicKeyToken=b77a5c561934e089"
           initializeData="true" />

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>
          <add name="FileLog"/>
          <!-- Uncomment to connect the application file log. -->
          <!-- <add name="FileLog" /> -->
          <!-- Uncomment to connect the event log. -->
          <!-- <add name="EventLog" /> -->
          <!-- Uncomment to connect the event log. -->
          <!-- <add name="Delimited" /> -->
          <!-- Uncomment to connect the XML log. -->
          <!-- <add name="XmlWriter" /> -->
          <!-- Uncomment to connect the console log. -->
          <!-- <add name="Console" /> -->
        </listeners>
      </source>
    </sources>
    <switches>
      <add name="DefaultSwitch" value="Information" />
    </switches>
    <sharedListeners>
      <add name="FileLog"
           type="Microsoft.VisualBasic.Logging.FileLogTraceListener, 
                 Microsoft.VisualBasic, Version=8.0.0.0, 
                 Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a"
           initializeData="FileLogWriter" />
      <add name="EventLog"
           type="System.Diagnostics.EventLogTraceListener, 
                 System, Version=2.0.0.0, 
                 Culture=neutral, PublicKeyToken=b77a5c561934e089"
           initializeData="sample application"/>
      <add name="Delimited" 
           type="System.Diagnostics.DelimitedListTraceListener, 
                 System, Version=2.0.0.0, 
                 Culture=neutral, PublicKeyToken=b77a5c561934e089"
           initializeData="c:\temp\sampleDelimitedFile.txt"
           traceOutputOptions="DateTime" />
      <add name="XmlWriter"
           type="System.Diagnostics.XmlWriterTraceListener, 
                 System, Version=2.0.0.0, 
                 Culture=neutral, PublicKeyToken=b77a5c561934e089"
           initializeData="c:\temp\sampleLogFile.xml" />
      <add name="Console"
           type="System.Diagnostics.ConsoleTraceListener, 
                 System, Version=2.0.0.0, 
                 Culture=neutral, PublicKeyToken=b77a5c561934e089"
           initializeData="true" />
    </sharedListeners>
  </system.diagnostics>
</configuration>

リスナーを再構成するには

<sharedListeners> セクションで、リスナーの <add> 要素を見つけます。
type 属性はリスナーの型の名前を表します。この型は TraceListener クラスを継承する必要があります。正しい型が確実に使用されるよう、型名には厳密な名前を使用します。詳細については、後述の「厳密な名前を指定された型を参照するには」を参照してください。

使用できる型のいくつかを以下に示します。
- Microsoft.VisualBasic.Logging.FileLogTraceListener リスナー。ファイルログに書き込みます。
- System.Diagnostics.EventLogTraceListener リスナー。initializeData パラメーターで指定された、コンピューターのイベントログに情報を書き込みます。
- System.Diagnostics.DelimitedListTraceListener リスナーおよび System.Diagnostics.XmlWriterTraceListener リスナー。initializeData パラメーターで指定されたファイルに書き込みます。
- System.Diagnostics.ConsoleTraceListener リスナー。コマンドラインコンソールに書き込みます。
他の型のログリスナーが情報を書き込む先については、その型のドキュメントを参照してください。
アプリケーションは、ログリスナーオブジェクトを作成するときに、コンストラクターのパラメーターとして initializeData 属性を渡します。 initializeData 属性の意味はトレースリスナーによって異なります。
アプリケーションは、ログリスナーを作成した後で、リスナーのプロパティを設定します。これらのプロパティは、<add> 要素の他の属性で定義されています。特定のリスナーのプロパティの詳細については、そのリスナーの型のドキュメントを参照してください。

厳密な名前を指定された型を参照するには

ログリスナーとして正しい型を確実に使用するために、完全修飾型名と厳密な名前のアセンブリ名を使用する必要があります。厳密な名前を指定された型の構文は次のとおりです。

<型名>, <アセンブリ名>, <バージョン番号>, <カルチャ>, <厳密な名前>
次のコード例は、完全修飾された型の厳密な名前を確認する方法を示します。この例では "System.Diagnostics.FileLogTraceListener" です。
```
Public Sub DisplayStrongName()
    Dim t As Type = GetType(Logging.FileLogTraceListener)
    MsgBox(t.FullName & ", " & t.Assembly.FullName)
End Sub
```
次に示すのが出力です。これを使用して、前述の「リスナーを追加するには」の手順で示した方法で、厳密な名前を指定された型を一意に参照できます。

Microsoft.VisualBasic.Logging.FileLogTraceListener, Microsoft.VisualBasic, Version=8.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a