Log.WriteEntry Methode

Referenz

Definition

Namespace:: Microsoft.VisualBasic.Logging

Assembly:: Microsoft.VisualBasic.dll

Assembly:: Microsoft.VisualBasic.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Schreibt eine Meldung in die Protokollüberwachung der Anwendung.

Überlädt

WriteEntry(String)	Schreibt eine Meldung in die Protokollüberwachung der Anwendung.
WriteEntry(String, TraceEventType)	Schreibt eine Meldung in die Protokollüberwachung der Anwendung.
WriteEntry(String, TraceEventType, Int32)	Schreibt eine Meldung in die Protokollüberwachung der Anwendung.

WriteEntry(String)

Schreibt eine Meldung in die Protokollüberwachung 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

Erforderlich. Die zu protokollierende Meldung. Wenn message den Wert Nothing aufweist, wird eine leere Zeichenfolge verwendet.

Ausnahmen

SecurityException

Teilweise vertrauenswürdiger Code ruft die Methode auf, schreibt jedoch in eine Ereignisprotokollüberwachung, die volle Vertrauenswürdigkeit erfordert.

Beispiele

Dieses Beispiel zeigt die Verwendung der My.Application.Log.WriteEntry -Methode zum Protokollieren von Ablaufprotokollinformationen. Weitere Informationen finden Sie unter Gewusst wie: Schreiben von Protokollmeldungen.

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

Dieses Codebeispiel kann nur innerhalb einer Clientanwendung ausgeführt werden. Ändern Sie My.Application.Log.WriteEntry für Webanwendungen in My.Log.WriteEntry .

Hinweise

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

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

Informationen dazu, welche Protokolllistener die Meldungen der WriteEntry Methode empfangen, finden Sie unter Exemplarische Vorgehensweise: Bestimmen, wo My.Application.Log Informationen schreibt. Sie können Standardprotokolllistener ändern. Weitere Informationen finden Sie unter Arbeiten mit Anwendungsprotokollen.

Für Überladungen, die das id Argument nicht annehmen, wird das id in das Protokoll geschrieben 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.

Beschreibung	Siehe
Schreiben von Ereignisinformationen in die Protokolllistener der Anwendung	How to: Schreiben von Protokollmeldungen
Bestimmen, wo `Log` Informationen geschrieben werden	Exemplarische Vorgehensweise: Bestimmen, wohin „My.Application.Log“ Informationen schreibt

Verfügbarkeit nach Projekttyp

Projekttyp	Verfügbar
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 Meldung in die Protokollüberwachung 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

Erforderlich. Die zu protokollierende Meldung. Wenn message den Wert Nothing aufweist, wird eine leere Zeichenfolge verwendet.

severity: TraceEventType

Der Typ der Meldung. Standardmäßig TraceEventType.Information.

Ausnahmen

InvalidEnumArgumentException

Der Meldungstyp ist keiner der TraceEventType-Enumerationswerte.

SecurityException

Teilweise vertrauenswürdiger Code ruft die Methode auf, schreibt jedoch in eine Ereignisprotokollüberwachung, die volle Vertrauenswürdigkeit erfordert.

Beispiele

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

Dieses Codebeispiel kann nur innerhalb einer Clientanwendung ausgeführt werden. Ändern Sie My.Application.Log.WriteEntry für Webanwendungen in My.Log.WriteEntry .

Hinweise

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

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

Für Überladungen, die das id Argument nicht annehmen, wird das id in das Protokoll geschrieben 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.

Beschreibung	Siehe
Schreiben von Ereignisinformationen in die Protokolllistener der Anwendung	How to: Schreiben von Protokollmeldungen
Bestimmen, wo `Log` Informationen geschrieben werden	Exemplarische Vorgehensweise: Bestimmen, wohin „My.Application.Log“ Informationen schreibt

Verfügbarkeit nach Projekttyp

Projekttyp	Verfügbar
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 Meldung in die Protokollüberwachung 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

Erforderlich. Die zu protokollierende Meldung. Wenn message den Wert Nothing aufweist, wird eine leere Zeichenfolge verwendet.

severity: TraceEventType

Der Typ der Meldung. Standardmäßig TraceEventType.Information.

id: Int32

Meldungs-ID, wird i. d. R. zur Korrelation verwendet. Standardmäßig bezieht sich auf, entryType wie in der Tabelle beschrieben.

Ausnahmen

InvalidEnumArgumentException

Der Meldungstyp ist keiner der TraceEventType-Enumerationswerte.

SecurityException

Teilweise vertrauenswürdiger Code ruft die Methode auf, schreibt jedoch in eine Ereignisprotokollüberwachung, die volle Vertrauenswürdigkeit erfordert.

Beispiele

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

Dieses Codebeispiel kann nur innerhalb einer Clientanwendung ausgeführt werden. Ändern Sie My.Application.Log.WriteEntry für Webanwendungen in My.Log.WriteEntry .

Hinweise

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

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

Für Überladungen, die das id Argument nicht annehmen, wird das id in das Protokoll geschrieben 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.

Beschreibung	Siehe
Schreiben von Ereignisinformationen in die Protokolllistener der Anwendung	How to: Schreiben von Protokollmeldungen
Bestimmen, wo `Log` Informationen geschrieben werden	Exemplarische Vorgehensweise: Bestimmen, wohin „My.Application.Log“ Informationen schreibt

Verfügbarkeit nach Projekttyp

Projekttyp	Verfügbar
Windows-Anwendung	Ja
Klassenbibliothek	Ja
Konsolenanwendung	Ja
Windows-Steuerelementbibliothek	Ja
Websteuerelementbibliothek	Nein
Windows-Dienst	Ja
Website	Ja

Weitere Informationen

Gilt für:

Freigeben über

Log.WriteEntry Methode

Definition

Überlädt

WriteEntry(String)

Parameter

Ausnahmen

Beispiele

Hinweise

Verfügbarkeit nach Projekttyp

Weitere Informationen

Gilt für:

WriteEntry(String, TraceEventType)

Parameter

Ausnahmen

Beispiele

Hinweise

Verfügbarkeit nach Projekttyp

Weitere Informationen

Gilt für:

WriteEntry(String, TraceEventType, Int32)

Parameter

Ausnahmen

Beispiele

Hinweise

Verfügbarkeit nach Projekttyp

Weitere Informationen

Gilt für:

Zusätzliche Ressourcen