Log.WriteEntry Methode
Definition
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
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
- TraceEventType
- Objekte (Visual Basic)
- Arbeiten mit Anwendungsprotokollen in Visual Basic
- How to: Schreiben von Protokollmeldungen
- Exemplarische Vorgehensweise: Bestimmen, wohin „My.Application.Log“ Informationen schreibt
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
Der Meldungstyp ist keiner der TraceEventType-Enumerationswerte.
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
- TraceEventType
- Objekte (Visual Basic)
- Arbeiten mit Anwendungsprotokollen in Visual Basic
- How to: Schreiben von Protokollmeldungen
- Exemplarische Vorgehensweise: Bestimmen, wohin „My.Application.Log“ Informationen schreibt
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
Der Meldungstyp ist keiner der TraceEventType-Enumerationswerte.
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
- TraceEventType
- Objekte (Visual Basic)
- Arbeiten mit Anwendungsprotokollen in Visual Basic
- How to: Schreiben von Protokollmeldungen
- Exemplarische Vorgehensweise: Bestimmen, wohin „My.Application.Log“ Informationen schreibt