逐步解說：篩選 My.Application.Log 輸出（Visual Basic）

本指南示範如何變更My.Application.Log物件的記錄篩選默認值，以控制從Log物件傳遞至偵聽器的資訊，以及偵聽器寫入的資訊。即使在建置應用程式之後，您仍可以變更記錄行為，因為組態資訊會儲存在應用程式的組態檔中。

入門指南

寫入的每個訊息 My.Application.Log 都有相關聯的嚴重性層級，其篩選機制會用來控制記錄輸出。此範例應用程式會使用 My.Application.Log 方法來寫入具有不同嚴重性層級的數個記錄訊息。

建置範例應用程式

開啟新的 Visual Basic Windows 應用程式專案。
將名為 Button1 的按鈕新增至 Form1。

在 Click Button1 的事件處理程式中，新增下列程式代碼：

' Activity tracing information
My.Application.Log.WriteEntry("Entering Button1_Click", TraceEventType.Start)

' Tracing information
My.Application.Log.WriteEntry("In Button1_Click", TraceEventType.Information)

' Create an exception to log.
Dim ex As New ApplicationException
' Exception information
My.Application.Log.WriteException(ex)

' Activity tracing information
My.Application.Log.WriteEntry("Leaving Button1_Click", TraceEventType.Stop)

在調試程式中執行應用程式。
按 Button1。

應用程式會將下列資訊寫入應用程式的偵錯輸出和記錄檔。

DefaultSource Information: 0 : In Button1_Click

DefaultSource Error: 2 : Error in the application.
關閉應用程式。

如需如何檢視應用程式偵錯輸出視窗的資訊，請參閱輸出視窗。如需應用程式記錄檔位置的資訊，請參閱逐步解說：判斷 My.Application.Log 寫入資訊的位置。

備註

根據預設，應用程式會在應用程式關閉時排清記錄檔輸出。

在上述範例中，對方法的第二次呼叫 WriteEntry 和方法的呼叫 WriteException 會產生記錄輸出，而對方法的第一次和最後一次呼叫 WriteEntry 則不會。這是因為 WriteEntry 和 WriteException 的嚴重性層級分別為「Information」和「Error」，這兩者都被 My.Application.Log 對象的默認日誌篩選所允許。不過，具有「Start」和「Stop」嚴重性層級的事件被禁止產生記錄輸出。

篩選所有 My.Application.Log 接聽程式

物件 My.Application.Log 使用名為 SourceSwitch 的 DefaultSwitch 來控制從 WriteEntry 和 WriteException 方法傳遞哪些訊息給日誌監聽器。您可以透過在應用程式的組態檔中，將 DefaultSwitch 的值設定為 SourceLevels 的其中一個列舉值，來進行設定。根據預設，其值為「資訊」。

下表顯示在特定的 DefaultSwitch 設定下，日誌記錄將訊息傳送給監聽器所需的嚴重性層級。

DefaultSwitch 值	輸出所需的訊息嚴重性
`Critical`	`Critical`
`Error`	`Critical` 或 `Error`
`Warning`	`Critical`、 `Error`或 `Warning`
`Information`	`Critical`、`Error`、`Warning`或 `Information`
`Verbose`	`Critical`、`Error`、`Warning`、`Information`或 `Verbose`
`ActivityTracing`	`Start`、`Stop`、`Suspend`、`Resume`或 `Transfer`
`All`	允許所有訊息。
`Off`	所有訊息都會遭到封鎖。

備註

WriteEntry和 WriteException 方法各有一個未指定嚴重性層級的多載。多載的 WriteEntry 隱含嚴重性層級為「資訊」，而多載的 WriteException 隱含嚴重性層級為「錯誤」。

下表說明了上一個範例中的記錄輸出：設定為預設的 DefaultSwitch "Information" 時，只有對 WriteEntry 方法的第二次呼叫和對 WriteException 方法的呼叫會產生記錄輸出。

僅記錄活動追蹤事件

以滑鼠右鍵點擊方案總管中的app.config，然後選取開啟。

-或-

如果沒有 app.config 檔案：
1. 在 [ 專案] 功能表上，選擇 [ 新增專案]。
2. 從 [ 新增專案] 對話框中，選擇 [應用程式組態檔]。
3. 按下新增。
請在最上層 <switches> 區段中的 <system.diagnostics> 區段中找到 <configuration> 區段。
尋找將 DefaultSwitch 加入開關集合的元素。它應該看起來類似這個元素：

<add name="DefaultSwitch" value="Information" />
將屬性的值 value 變更為「ActivityTracing」。

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"/>
        </listeners>
      </source>
    </sources>
    <switches>
      <add name="DefaultSwitch" value="ActivityTracing" />
    </switches>
    <sharedListeners>
      <add name="FileLog"
           type="Microsoft.VisualBasic.Logging.FileLogTraceListener,
                 Microsoft.VisualBasic, Version=8.0.0.0,
                 Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a,
                 processorArchitecture=MSIL"
           initializeData="FileLogWriter"/>
    </sharedListeners>
  </system.diagnostics>
</configuration>

在調試程式中執行應用程式。
按 Button1。

應用程式會將下列資訊寫入應用程式的偵錯輸出和記錄檔：

DefaultSource Start: 4 : Entering Button1_Click

DefaultSource Stop: 5 : Leaving Button1_Click
關閉應用程式。
將屬性的值 value 變更回「Information」。

備註

DefaultSwitch 開關設定僅控制 My.Application.Log。它不會變更 .NET System.Diagnostics.Trace 和 System.Diagnostics.Debug 類別的行為。

My.Application.Log 監聽器的單獨篩選

上一個範例示範如何變更所有 My.Application.Log 輸出的篩選。此範例示範如何篩選個別記錄接聽程式。根據預設，應用程式有兩個接聽程式會寫入應用程式的偵錯輸出和記錄檔。

設定檔透過允許每個日誌監聽器設有篩選器來控制其行為，這就像是為My.Application.Log添加了一個開關。只有當記錄檔和記錄接聽程式的篩選器都允許訊息的嚴重性時，記錄接聽程式才會輸出訊息。

此範例示範如何設定新偵錯接聽程序的篩選，並將它新增至 Log 物件。默認偵錯接聽程式應該從 Log 物件中移除，因此很明顯偵錯訊息來自新的偵錯接聽程式。

僅記錄活動追蹤事件

按一下滑鼠右鍵 方案總管 中的 app.config，然後選擇開啟。

-或-

如果沒有 app.config 檔案：
1. 在 [ 專案] 功能表上，選擇 [ 新增專案]。
2. 從 [ 新增專案] 對話框中，選擇 [應用程式組態檔]。
3. 按下新增。
在方案總管中右鍵單擊 app.config。選擇 [開啟]。
在 <listeners> 區段底下的 <source> 區段中，找出具有“DefaultSource”作為 name 屬性的 <sources> 區段。 <sources> 區段位於 <system.diagnostics> 區段之下，並且在最上層 <configuration> 區段中。

將此元素新增到 <listeners> 區段：

<!-- Remove the default debug listener. -->
<remove name="Default"/>
<!-- Add a filterable debug listener. -->
<add name="NewDefault"/>

在 <sharedListeners> 區段中，在最上層 <system.diagnostics> 區段內，找出 <configuration> 區段。

請將此元素新增到該 <sharedListeners> 區段：

<add name="NewDefault"
     type="System.Diagnostics.DefaultTraceListener,
           System, Version=2.0.0.0, Culture=neutral,
           PublicKeyToken=b77a5c561934e089,
           processorArchitecture=MSIL">
    <filter type="System.Diagnostics.EventTypeFilter"
            initializeData="Error" />
</add>

篩選條件 EventTypeFilter 會採用其中 SourceLevels 一個列舉值作為其 initializeData 屬性。

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"/>
          <!-- Remove the default debug listener. -->
          <remove name="Default"/>
          <!-- Add a filterable debug listener. -->
          <add name="NewDefault"/>
        </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,
                 processorArchitecture=MSIL"
           initializeData="FileLogWriter"/>
      <add name="NewDefault"
           type="System.Diagnostics.DefaultTraceListener,
                 System, Version=2.0.0.0, Culture=neutral,
                 PublicKeyToken=b77a5c561934e089,
                 processorArchitecture=MSIL">
        <filter type="System.Diagnostics.EventTypeFilter"
                initializeData="Error" />
      </add>
    </sharedListeners>
  </system.diagnostics>
</configuration>

在調試程式中執行應用程式。
按 Button1。

應用程式會將下列資訊寫入至應用程式的記錄檔：

Default Information: 0 : In Button1_Click

Default Error: 2 : Error in the application.

應用程式會將較少的資訊寫入至應用程式的偵錯輸出，因為篩選條件比較嚴格。

Default Error 2 Error
關閉應用程式。

如需部署後變更記錄設定的詳細資訊，請參閱使用應用程式記錄。

另請參閱

意見反應

此頁面對您有幫助嗎？

Last updated on 2025-06-17

逐步解說：篩選 My.Application.Log 輸出 （Visual Basic）

入門指南

建置範例應用程式

篩選所有 My.Application.Log 接聽程式

僅記錄活動追蹤事件

My.Application.Log 監聽器的單獨篩選

僅記錄活動追蹤事件

另請參閱

意見反應

其他資源

逐步解說：篩選 My.Application.Log 輸出（Visual Basic）