Freigeben über


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:

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.

severity

Standard-id

Information

0

Warning

1

Error

2

Critical

3

Start

4

Stop

5

Suspend

6

Resume

7

Verbose

8

Transfer

9

Aufgaben

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

Zweck

Weitere Informationen finden Sie unter

Schreiben von Ereignisinformationen in die Protokollüberwachungen der Anwendung

Gewusst wie: Schreiben von Protokollmeldungen

Bestimmen des Ziels, in das Log Informationen schreibt

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

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

Projekttyp

Verfügbar

Windows-Anwendung

Ja

Klassenbibliothek

Ja

Konsolenanwendung

Ja

Windows-Steuerelementbibliothek

Ja

Web-Steuerelementbibliothek

Nein

Windows-Dienst

Ja

Website

Ja

Berechtigungen

Die folgende Berechtigung ist möglicherweise erforderlich:

Berechtigung

Beschreibung

FileIOPermission

Steuert die Fähigkeit, auf Dateien und Ordner zuzugreifen. Zugeordnete Enumeration: Unrestricted.

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