共用方式為


Log.WriteEntry 方法

定義

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

多載

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

必要。 要記錄的訊息。 如果 messageNothing,則會使用空字串。

例外狀況

具有部分信任的程式碼呼叫方法,但要寫入需要完全信任的事件記錄檔接聽程式 (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.WriteEntryMy.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

必要。 要記錄的訊息。 如果 messageNothing,則會使用空字串。

severity
TraceEventType

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

例外狀況

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

具有部分信任的程式碼呼叫方法,但要寫入需要完全信任的事件記錄檔接聽程式 (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.WriteEntryMy.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

必要。 要記錄的訊息。 如果 messageNothing,則會使用空字串。

severity
TraceEventType

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

id
Int32

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

例外狀況

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

具有部分信任的程式碼呼叫方法,但要寫入需要完全信任的事件記錄檔接聽程式 (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.WriteEntryMy.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 服務
網站

另請參閱

適用於