WriteEntry-Methode ("My.Application.Log" und "My.Log")

Aktualisiert: November 2007

Schreibt eine Meldung in die Protokollüberwachungen der Anwendung.

' Usage
My.Application.Log.WriteEntry(message)
My.Application.Log.WriteEntry(message ,severity)
My.Application.Log.WriteEntry(message ,severity ,id)
' Web usage
My.Log.WriteEntry(message)
My.Log.WriteEntry(message ,severity)
My.Log.WriteEntry(message ,severity ,id)
' Declaration
Public Sub WriteEntry( _
   ByVal message As String _
)
' -or-
Public Sub WriteEntry( _
   ByVal message As String, _
   ByVal severity As System.Diagnostics.TraceEventType _
)
' -or-
Public Sub WriteEntry( _
   ByVal message As String, _
   ByVal severity As System.Diagnostics.TraceEventType, _
   ByVal id As Integer _
)

Parameter

• message
  Erforderlich. Die zu protokollierende Meldung. Wenn messageNothing ist, wird eine leere Zeichenfolge verwendet.

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

• id
  Meldungsbezeichner, i. d. R. für Korrelation verwendet. Bezieht sich standardmäßig auf entryType, wie in der Tabelle beschrieben.

Ausnahmen

Die folgenden Bedingungen verursachen eine Ausnahme:

• Der Ausnahme- oder Meldungstyp ist Nothing (ArgumentNullException).

• Der Meldungstyp ist keiner der TraceEventType-Enumerationswerte (InvalidEnumArgumentException).

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

Hinweise

Die WriteEntry-Methode schreibt eine Meldung in die Ereignisprotokollüberwachungen 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 über die Protokollüberwachungen, die Meldungen der WriteEntry-Methode empfangen, finden Sie unter Exemplarische Vorgehensweise: Bestimmen, wohin "My.Application.Log" Informationen schreibt. Sie können Standardprotokollüberwachungen ändern. Weitere Informationen finden Sie unter Arbeiten mit Anwendungsprotokollen in Visual Basic.

Für Überladungen, die das id-Argument nicht akzeptieren, wird die in das Protokoll geschriebene id in der folgenden Tabelle definiert.

Aufgaben

In der folgenden Tabelle werden Beispiele für Aufgaben mit der WriteEntry-Methode aufgeführt.

Beispiel

In diesem Beispiel wird die Verwendung der My.Application.Log.WriteEntry-Methode zum Protokollieren von Ablaufverfolgungsinformationen veranschaulicht. 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 in einer Clientanwendung ausgeführt werden. Ändern Sie für Webanwendungen My.Application.Log.WriteEntry in My.Log.WriteEntry.

Anforderungen

Namespace:Microsoft.VisualBasic.Logging

Klasse:Log

**Assembly:**Visual Basic Runtime Library (in Microsoft.VisualBasic.dll)

Verfügbarkeit nach Projekttyp

Berechtigungen

Die folgende Berechtigung ist möglicherweise erforderlich:

Weitere Informationen finden Sie unter Codezugriffssicherheit und unter Anfordern von Berechtigungen.

Siehe auch

Aufgaben

Gewusst wie: Schreiben von Protokollmeldungen

Exemplarische Vorgehensweise: Bestimmen, wohin "My.Application.Log" Informationen schreibt

Konzepte

Arbeiten mit Anwendungsprotokollen in Visual Basic

Referenz

My.Application.Log-Objekt

My.Log-Objekt

System.Diagnostics.TraceEventType

Log.WriteEntry