Log.WriteEntry 方法

定義

命名空間:

Microsoft.VisualBasic.Logging

組件:

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 服務	是
網站	是

另請參閱

• TraceEventType
• 物件 (Visual Basic)
• 在 Visual Basic 中使用應用程式記錄檔
• 作法：寫入記錄檔訊息
• 逐步解說：判斷 My.Application.Log 寫入資訊的位置

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 服務	是
網站	是

另請參閱

• TraceEventType
• 物件 (Visual Basic)
• 在 Visual Basic 中使用應用程式記錄檔
• 作法：寫入記錄檔訊息
• 逐步解說：判斷 My.Application.Log 寫入資訊的位置

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 服務	是
網站	是

另請參閱

• TraceEventType
• 物件 (Visual Basic)
• 在 Visual Basic 中使用應用程式記錄檔
• 作法：寫入記錄檔訊息
• 逐步解說：判斷 My.Application.Log 寫入資訊的位置