共用方式為

Log.WriteEntry 方法

  • 參考

定義

命名空間:
Microsoft.VisualBasic.Logging
組件:
Microsoft.VisualBasic.dll
組件:
Microsoft.VisualBasic.Forms.dll

將訊息寫入至應用程式的記錄檔接聽程式。

多載

WriteEntry(String)

將訊息寫入至應用程式的記錄檔接聽程式。
WriteEntry(String, TraceEventType)

將訊息寫入至應用程式的記錄檔接聽程式。
WriteEntry(String, TraceEventType, Int32)

將訊息寫入至應用程式的記錄檔接聽程式。

WriteEntry(String)

將訊息寫入至應用程式的記錄檔接聽程式。

public:
 void WriteEntry(System::String ^ message);
public void WriteEntry (string message);
member this.WriteEntry : string -> unit
Public Sub WriteEntry (message As String)

參數

message
String

必要。 要記錄的訊息。 如果 message 為 Nothing，則會使用空字串。

例外狀況

SecurityException

具有部分信任的程式碼呼叫方法，但要寫入需要完全信任的事件記錄檔接聽程式 (Listener)。

範例

此範例示範如何使用 My.Application.Log.WriteEntry 方法寫入追蹤資訊。 如需詳細資訊，請參閱 如何：寫入記錄訊息。

Public Sub TracingTest(ByVal fileName As String)
    My.Application.Log.WriteEntry( 
        "Entering TracingTest with argument " & 
        fileName & ".")
    ' Code to trace goes here.
    My.Application.Log.WriteEntry( 
        "Exiting TracingTest with argument " & 
        fileName & ".")
End Sub

此程式代碼範例只能在用戶端應用程式內執行。 針對 Web 應用程式變更 My.Application.Log.WriteEntry 為 My.Log.WriteEntry 。

備註

方法 WriteEntry 會將訊息寫入應用程式的事件記錄檔接聽程式。

在用戶端應用程式中 Log ，對象可透過 My.Application.Log 物件取得。 在 Web 應用程式中， Log 物件可透過 My.Log 物件取得。

若要瞭解哪些記錄檔接聽程式會收到 WriteEntry 方法的訊息，請參閱 逐步解說：判斷 My.Application.Log 寫入資訊的位置。 您可以變更預設記錄檔接聽程式。 如需詳細資訊，請參閱使用應用程式記錄檔。

對於不採用 id 自變數的多載， id 寫入記錄檔的 定義方式如下表所示。

severity 預設 id
Information 0
Warning 1
Error 2
Critical 3
Start 4
Stop 5
Suspend 6
Resume 7
Verbose 8
Transfer 9

下表列出涉及 方法的工作 WriteEntry 範例。

收件者 請參閱
將事件資訊寫入應用程式的記錄檔接聽程式 作法：寫入記錄檔訊息
判斷寫入資訊的位置Log 逐步解說：判斷 My.Application.Log 寫入資訊的位置

依專案類型的可用性

專案類型 可用
Windows 應用程式 是
類別庫 是
主控台應用程式 是
Windows 控制項程式庫 是
Web 控制項程式庫 否
Windows 服務 是
網站 是

另請參閱

適用於

WriteEntry(String, TraceEventType)

將訊息寫入至應用程式的記錄檔接聽程式。

public:
 void WriteEntry(System::String ^ message, System::Diagnostics::TraceEventType severity);
public void WriteEntry (string message, System.Diagnostics.TraceEventType severity);
member this.WriteEntry : string * System.Diagnostics.TraceEventType -> unit
Public Sub WriteEntry (message As String, severity As TraceEventType)

參數

message
String

必要。 要記錄的訊息。 如果 message 為 Nothing，則會使用空字串。

severity
TraceEventType

訊息的類型。 預設值為 TraceEventType.Information。

例外狀況

InvalidEnumArgumentException

訊息類型不是其中一個 TraceEventType 列舉值。

SecurityException

具有部分信任的程式碼呼叫方法，但要寫入需要完全信任的事件記錄檔接聽程式 (Listener)。

範例

此範例示範如何使用 My.Application.Log.WriteEntry 方法寫入追蹤資訊。 如需詳細資訊，請參閱 如何：寫入記錄訊息。

Public Sub TracingTest(ByVal fileName As String)
    My.Application.Log.WriteEntry( 
        "Entering TracingTest with argument " & 
        fileName & ".")
    ' Code to trace goes here.
    My.Application.Log.WriteEntry( 
        "Exiting TracingTest with argument " & 
        fileName & ".")
End Sub

此程式代碼範例只能在用戶端應用程式內執行。 針對 Web 應用程式變更 My.Application.Log.WriteEntry 為 My.Log.WriteEntry 。

備註

方法 WriteEntry 會將訊息寫入應用程式的事件記錄檔接聽程式。

在用戶端應用程式中 Log ，對象可透過 My.Application.Log 物件取得。 在 Web 應用程式中， Log 物件可透過 My.Log 物件取得。

若要瞭解哪些記錄檔接聽程式會收到 WriteEntry 方法的訊息，請參閱 逐步解說：判斷 My.Application.Log 寫入資訊的位置。 您可以變更預設記錄檔接聽程式。 如需詳細資訊，請參閱使用應用程式記錄檔。

對於不採用 id 自變數的多載， id 寫入記錄檔的 定義方式如下表所示。

severity 預設 id
Information 0
Warning 1
Error 2
Critical 3
Start 4
Stop 5
Suspend 6
Resume 7
Verbose 8
Transfer 9

下表列出涉及 方法的工作 WriteEntry 範例。

收件者 請參閱
將事件資訊寫入應用程式的記錄檔接聽程式 作法：寫入記錄檔訊息
判斷寫入資訊的位置Log 逐步解說：判斷 My.Application.Log 寫入資訊的位置

依專案類型的可用性

專案類型 可用
Windows 應用程式 是
類別庫 是
主控台應用程式 是
Windows 控制項程式庫 是
Web 控制項程式庫 否
Windows 服務 是
網站 是

另請參閱

適用於

WriteEntry(String, TraceEventType, Int32)

將訊息寫入至應用程式的記錄檔接聽程式。

public:
 void WriteEntry(System::String ^ message, System::Diagnostics::TraceEventType severity, int id);
public void WriteEntry (string message, System.Diagnostics.TraceEventType severity, int id);
member this.WriteEntry : string * System.Diagnostics.TraceEventType * int -> unit
Public Sub WriteEntry (message As String, severity As TraceEventType, id As Integer)

參數

message
String

必要。 要記錄的訊息。 如果 message 為 Nothing，則會使用空字串。

severity
TraceEventType

訊息的類型。 預設值為 TraceEventType.Information。

id
Int32

訊息識別項，通常用於相互關聯。 根據預設，與數據表中所述相關 entryType 。

例外狀況

InvalidEnumArgumentException

訊息類型不是其中一個 TraceEventType 列舉值。

SecurityException

具有部分信任的程式碼呼叫方法，但要寫入需要完全信任的事件記錄檔接聽程式 (Listener)。

範例

此範例示範如何使用 My.Application.Log.WriteEntry 方法寫入追蹤資訊。 如需詳細資訊，請參閱 如何：寫入記錄訊息。

Public Sub TracingTest(ByVal fileName As String)
    My.Application.Log.WriteEntry( 
        "Entering TracingTest with argument " & 
        fileName & ".")
    ' Code to trace goes here.
    My.Application.Log.WriteEntry( 
        "Exiting TracingTest with argument " & 
        fileName & ".")
End Sub

此程式代碼範例只能在用戶端應用程式內執行。 針對 Web 應用程式變更 My.Application.Log.WriteEntry 為 My.Log.WriteEntry 。

備註

方法 WriteEntry 會將訊息寫入應用程式的事件記錄檔接聽程式。

在用戶端應用程式中 Log ，對象可透過 My.Application.Log 物件取得。 在 Web 應用程式中， Log 物件可透過 My.Log 物件取得。

若要瞭解哪些記錄檔接聽程式會收到 WriteEntry 方法的訊息，請參閱 逐步解說：判斷 My.Application.Log 寫入資訊的位置。 您可以變更預設記錄檔接聽程式。 如需詳細資訊，請參閱使用應用程式記錄檔。

對於不採用 id 自變數的多載， id 寫入記錄檔的 定義方式如下表所示。

severity 預設 id
Information 0
Warning 1
Error 2
Critical 3
Start 4
Stop 5
Suspend 6
Resume 7
Verbose 8
Transfer 9

下表列出涉及 方法的工作 WriteEntry 範例。

收件者 請參閱
將事件資訊寫入應用程式的記錄檔接聽程式 作法：寫入記錄檔訊息
判斷寫入資訊的位置Log 逐步解說：判斷 My.Application.Log 寫入資訊的位置

依專案類型的可用性

專案類型 可用
Windows 應用程式 是
類別庫 是
主控台應用程式 是
Windows 控制項程式庫 是
Web 控制項程式庫 否
Windows 服務 是
網站 是

另請參閱

適用於