Log.WriteEntry Methode

Definition

Namespace:
Microsoft.VisualBasic.Logging
Assembly:
Microsoft.VisualBasic.dll

Schreibt eine Nachricht in die Protokolllistener der Anwendung.

Überlädt

Name Beschreibung
WriteEntry(String)

Schreibt eine Nachricht in die Protokolllistener der Anwendung.
WriteEntry(String, TraceEventType)

Schreibt eine Nachricht in die Protokolllistener der Anwendung.
WriteEntry(String, TraceEventType, Int32)

Schreibt eine Nachricht in die Protokolllistener der Anwendung.

WriteEntry(String)

Schreibt eine Nachricht in die Protokolllistener der Anwendung.

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

Parameter

message
String

Required. Die zu protokollierende Nachricht. Wenn message dies der Wert ist Nothing, wird eine leere Zeichenfolge verwendet.

Ausnahmen

SecurityException

Code mit teilweiser Vertrauensstellung ruft die Methode auf, schreibt jedoch in einen Ereignisprotokolllistener, der volle Vertrauenswürdige erfordert.

Beispiele

In diesem Beispiel wird gezeigt, wie Die Methode zum Protokollieren von Ablaufverfolgungsinformationen verwendet My.Application.Log.WriteEntry wird. Weitere Informationen finden Sie unter How to: Write Log Messages.

Private Sub GetOpenFormTitles()
    Dim formTitles As New Collection

    Try
        For Each f As Form In My.Application.OpenForms
            ' Use a thread-safe method to get all form titles.
            formTitles.Add(GetFormTitle(f))
        Next
    Catch ex As Exception
        formTitles.Add("Error: " & ex.Message)
    End Try

    Form1.ListBox1.DataSource = formTitles
End Sub

Private Delegate Function GetFormTitleDelegate(f As Form) As String
Private Function GetFormTitle(f As Form) As String
    ' Check if the form can be accessed from the current thread.
    If Not f.InvokeRequired Then
        ' Access the form directly.
        Return f.Text
    Else
        ' Marshal to the thread that owns the form. 
        Dim del As GetFormTitleDelegate = AddressOf GetFormTitle
        Dim param As Object() = {f}
        Dim result As System.IAsyncResult = f.BeginInvoke(del, param)
        ' Give the form's thread a chance process function.
        System.Threading.Thread.Sleep(10)
        ' Check the result.
        If result.IsCompleted Then
            ' Get the function's return value.
            Return "Different thread: " & f.EndInvoke(result).ToString
        Else
            Return "Unresponsive thread"
        End If
    End If
End Function

Dieses Codebeispiel kann nur innerhalb einer Clientanwendung ausgeführt werden. My.Log.WriteEntry Für Webanwendungen ändernMy.Application.Log.WriteEntry.

Hinweise

Die WriteEntry Methode schreibt eine Nachricht in die Ereignisprotokolllistener der Anwendung.

In Clientanwendungen ist das Objekt über das LogMy.Application.Log Objekt verfügbar. In Webanwendungen ist das Log Objekt über das My.Log Objekt verfügbar.

Informationen dazu, welche Protokolllistener die Nachrichten der WriteEntry Methode empfangen, finden Sie unter Walkthrough: Determining Where My.Application.Log Writes Information. Sie können Standardprotokolllistener ändern. Weitere Informationen finden Sie unter Arbeiten mit Anwendungsprotokollen.

Bei Überladungen, die das id Argument nicht verwenden, wird das id in das Protokoll geschriebene Protokoll durch die folgende Tabelle definiert.

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

In der folgenden Tabelle sind Beispiele für Aufgaben aufgeführt, die die WriteEntry Methode betreffen.

To Siehe
Schreiben von Ereignisinformationen in die Protokolllistener der Anwendung Gewusst wie: Schreiben von Protokollnachrichten
Bestimmen, wo Log Informationen geschrieben werden Anleitung: Ermitteln, wo My.Application.Log Informationen ablegt

Verfügbarkeit nach Projekttyp

Projekttyp Available
Windows-Anwendung Ja
Klassenbibliothek Ja
Konsolenanwendung Ja
Windows-Steuerelementbibliothek Ja
Websteuerelementbibliothek Nein
Windows-Dienst Ja
Website Ja

Weitere Informationen

Gilt für:

WriteEntry(String, TraceEventType)

Schreibt eine Nachricht in die Protokolllistener der Anwendung.

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)

Parameter

message
String

Required. Die zu protokollierende Nachricht. Wenn message dies der Wert ist Nothing, wird eine leere Zeichenfolge verwendet.

severity
TraceEventType

Der Typ der Nachricht. Standardmäßig ist dies TraceEventType.Information.

Ausnahmen

InvalidEnumArgumentException

Der Nachrichtentyp ist keiner der TraceEventType Enumerationswerte.

SecurityException

Code mit teilweiser Vertrauensstellung ruft die Methode auf, schreibt jedoch in einen Ereignisprotokolllistener, der volle Vertrauenswürdige erfordert.

Beispiele

In diesem Beispiel wird gezeigt, wie Die Methode zum Protokollieren von Ablaufverfolgungsinformationen verwendet My.Application.Log.WriteEntry wird. Weitere Informationen finden Sie unter How to: Write Log Messages.

Private Sub GetOpenFormTitles()
    Dim formTitles As New Collection

    Try
        For Each f As Form In My.Application.OpenForms
            ' Use a thread-safe method to get all form titles.
            formTitles.Add(GetFormTitle(f))
        Next
    Catch ex As Exception
        formTitles.Add("Error: " & ex.Message)
    End Try

    Form1.ListBox1.DataSource = formTitles
End Sub

Private Delegate Function GetFormTitleDelegate(f As Form) As String
Private Function GetFormTitle(f As Form) As String
    ' Check if the form can be accessed from the current thread.
    If Not f.InvokeRequired Then
        ' Access the form directly.
        Return f.Text
    Else
        ' Marshal to the thread that owns the form. 
        Dim del As GetFormTitleDelegate = AddressOf GetFormTitle
        Dim param As Object() = {f}
        Dim result As System.IAsyncResult = f.BeginInvoke(del, param)
        ' Give the form's thread a chance process function.
        System.Threading.Thread.Sleep(10)
        ' Check the result.
        If result.IsCompleted Then
            ' Get the function's return value.
            Return "Different thread: " & f.EndInvoke(result).ToString
        Else
            Return "Unresponsive thread"
        End If
    End If
End Function

Dieses Codebeispiel kann nur innerhalb einer Clientanwendung ausgeführt werden. My.Log.WriteEntry Für Webanwendungen ändernMy.Application.Log.WriteEntry.

Hinweise

Die WriteEntry Methode schreibt eine Nachricht in die Ereignisprotokolllistener der Anwendung.

In Clientanwendungen ist das Objekt über das LogMy.Application.Log Objekt verfügbar. In Webanwendungen ist das Log Objekt über das My.Log Objekt verfügbar.

Informationen dazu, welche Protokolllistener die Nachrichten der WriteEntry Methode empfangen, finden Sie unter Walkthrough: Determining Where My.Application.Log Writes Information. Sie können Standardprotokolllistener ändern. Weitere Informationen finden Sie unter Arbeiten mit Anwendungsprotokollen.

Bei Überladungen, die das id Argument nicht verwenden, wird das id in das Protokoll geschriebene Protokoll durch die folgende Tabelle definiert.

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

In der folgenden Tabelle sind Beispiele für Aufgaben aufgeführt, die die WriteEntry Methode betreffen.

To Siehe
Schreiben von Ereignisinformationen in die Protokolllistener der Anwendung Gewusst wie: Schreiben von Protokollnachrichten
Bestimmen, wo Log Informationen geschrieben werden Anleitung: Ermitteln, wo My.Application.Log Informationen ablegt

Verfügbarkeit nach Projekttyp

Projekttyp Available
Windows-Anwendung Ja
Klassenbibliothek Ja
Konsolenanwendung Ja
Windows-Steuerelementbibliothek Ja
Websteuerelementbibliothek Nein
Windows-Dienst Ja
Website Ja

Weitere Informationen

Gilt für:

WriteEntry(String, TraceEventType, Int32)

Schreibt eine Nachricht in die Protokolllistener der Anwendung.

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)

Parameter

message
String

Required. Die zu protokollierende Nachricht. Wenn message dies der Wert ist Nothing, wird eine leere Zeichenfolge verwendet.

severity
TraceEventType

Der Typ der Nachricht. Standardmäßig ist dies TraceEventType.Information.

id
Int32

Nachrichtenbezeichner, der in der Regel für Korrelation verwendet wird. In Bezug auf die in der Tabelle beschriebene Standardeinstellung.By default, related to entryType as described in the table.

Ausnahmen

InvalidEnumArgumentException

Der Nachrichtentyp ist keiner der TraceEventType Enumerationswerte.

SecurityException

Code mit teilweiser Vertrauensstellung ruft die Methode auf, schreibt jedoch in einen Ereignisprotokolllistener, der volle Vertrauenswürdige erfordert.

Beispiele

In diesem Beispiel wird gezeigt, wie Die Methode zum Protokollieren von Ablaufverfolgungsinformationen verwendet My.Application.Log.WriteEntry wird. Weitere Informationen finden Sie unter How to: Write Log Messages.

Private Sub GetOpenFormTitles()
    Dim formTitles As New Collection

    Try
        For Each f As Form In My.Application.OpenForms
            ' Use a thread-safe method to get all form titles.
            formTitles.Add(GetFormTitle(f))
        Next
    Catch ex As Exception
        formTitles.Add("Error: " & ex.Message)
    End Try

    Form1.ListBox1.DataSource = formTitles
End Sub

Private Delegate Function GetFormTitleDelegate(f As Form) As String
Private Function GetFormTitle(f As Form) As String
    ' Check if the form can be accessed from the current thread.
    If Not f.InvokeRequired Then
        ' Access the form directly.
        Return f.Text
    Else
        ' Marshal to the thread that owns the form. 
        Dim del As GetFormTitleDelegate = AddressOf GetFormTitle
        Dim param As Object() = {f}
        Dim result As System.IAsyncResult = f.BeginInvoke(del, param)
        ' Give the form's thread a chance process function.
        System.Threading.Thread.Sleep(10)
        ' Check the result.
        If result.IsCompleted Then
            ' Get the function's return value.
            Return "Different thread: " & f.EndInvoke(result).ToString
        Else
            Return "Unresponsive thread"
        End If
    End If
End Function

Dieses Codebeispiel kann nur innerhalb einer Clientanwendung ausgeführt werden. My.Log.WriteEntry Für Webanwendungen ändernMy.Application.Log.WriteEntry.

Hinweise

Die WriteEntry Methode schreibt eine Nachricht in die Ereignisprotokolllistener der Anwendung.

In Clientanwendungen ist das Objekt über das LogMy.Application.Log Objekt verfügbar. In Webanwendungen ist das Log Objekt über das My.Log Objekt verfügbar.

Informationen dazu, welche Protokolllistener die Nachrichten der WriteEntry Methode empfangen, finden Sie unter Walkthrough: Determining Where My.Application.Log Writes Information. Sie können Standardprotokolllistener ändern. Weitere Informationen finden Sie unter Arbeiten mit Anwendungsprotokollen.

Bei Überladungen, die das id Argument nicht verwenden, wird das id in das Protokoll geschriebene Protokoll durch die folgende Tabelle definiert.

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

In der folgenden Tabelle sind Beispiele für Aufgaben aufgeführt, die die WriteEntry Methode betreffen.

To Siehe
Schreiben von Ereignisinformationen in die Protokolllistener der Anwendung Gewusst wie: Schreiben von Protokollnachrichten
Bestimmen, wo Log Informationen geschrieben werden Anleitung: Ermitteln, wo My.Application.Log Informationen ablegt

Verfügbarkeit nach Projekttyp

Projekttyp Available
Windows-Anwendung Ja
Klassenbibliothek Ja
Konsolenanwendung Ja
Windows-Steuerelementbibliothek Ja
Websteuerelementbibliothek Nein
Windows-Dienst Ja
Website Ja

Weitere Informationen

Gilt für: