共用方式為


逐步解說:變更 My.Application.Log 寫入資訊的位置 (Visual Basic)

您可以使用 My.Application.LogMy.Log 物件來記錄應用程式中發生之事件的相關資訊。 本逐步解說示範如何覆寫預設設定,而且使 Log 物件寫入至其他記錄檔接聽程式。

必要條件

Log 物件可以將資訊寫入數個記錄檔接聽程式。 在變更設定前,您需要判斷目前的記錄檔接聽程式設定。 如需詳細資訊,請參閱逐步解說:判斷 My.Application.Log 寫入資訊的位置

您也可以檢閱如何:將事件資訊寫入至文字檔,或如何:寫入應用程式事件記錄檔

加入接聽程式

  1. 方案總管 中,以滑鼠右鍵按一下 app.config 並選擇 [開啟]

    - 或 -

    如果沒有 app.config 檔案︰

    1. 在 [ 專案 ] 功能表中,選擇 [ 加入新項目]。

    2. 在 [加入新項目] 對話方塊中,選取 [應用程式組態檔]

    3. 按一下新增

  2. 找出 <listeners> 區段,其位於 <source> 區段中具有 name 屬性 "DefaultSource" 的 <sources> 區段下。 <sources> 區段位於最上層 <system.diagnostics> 區段中的 <configuration> 區段。

  3. 將這些項目加入至該 <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" /> -->
    
  4. 取消註解您想要收到 Log 訊息的記錄檔接聽程式。

  5. 找出位於最上層 <sharedListeners> 區段中 <system.diagnostics> 區段的 <configuration> 區段。

  6. 將這些項目加入至該 <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" />
    
  7. 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>
    

重新設定接聽程式

  1. <add> 區段找出接聽程式的 <sharedListeners> 項目。

  2. type 屬性提供接聽程式類型的名稱。 此類型必須繼承自 TraceListener 類別。 使用以強式名稱方式命名的類型名稱來確定使用了正確的類型。 如需詳細資訊,請參閱下列<參考強制命名的類型>一節。

    您可以使用的類型如下︰

    如需其他記錄檔接聽程式類型在何處寫入資訊的相關資訊,請查閱該類型的文件。

  3. 當應用程式建立記錄檔接聽程式物件時,會傳遞 initializeData 屬性作為建構函式參數。 initializeData 屬性的意義取決於追蹤接聽項。

  4. 建立記錄檔接聽程式之後,應用程式會設定接聽程式的屬性。 這些屬性由 <add> 項目中的其他屬性定義。 如需特定接聽程式屬性的詳細資訊,請參閱該接聽程式類型的文件。

參考強式命名的類型

  1. 若要確保記錄檔接聽程式使用正確的類型,請務必使用完整類型名稱和強式命名的組件名稱。 強式命名的類型語法如下所示︰

    <類型名稱>, <組件名稱>, <版本號碼>, <文化特性 (Culture)>, <強式名稱>

  2. 這個程式碼範例示範在此情況下如何判斷完整類型 "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

另請參閱