Log.WriteException Metoda

Definicja

Przestrzeń nazw:

Microsoft.VisualBasic.Logging

Zestaw:

Microsoft.VisualBasic.Forms.dll

Zapisuje informacje o wyjątkach do odbiorników dzienników aplikacji.

Przeciążenia

WriteException(Exception)	Zapisuje informacje o wyjątkach do odbiorników dziennika aplikacji.
WriteException(Exception, TraceEventType, String)	Zapisuje informacje o wyjątkach do odbiorników dziennika aplikacji.
WriteException(Exception, TraceEventType, String, Int32)	Zapisuje informacje o wyjątkach do odbiorników dziennika aplikacji.

WriteException(Exception)

Zapisuje informacje o wyjątkach do odbiorników dziennika aplikacji.

public:
 void WriteException(Exception ^ ex);

public void WriteException (Exception ex);

member this.WriteException : Exception -> unit

Public Sub WriteException (ex As Exception)

Parametry

ex

Exception

Wymagane. Wyjątek do rejestrowania.

Wyjątki

ArgumentNullException

ex to Nothing.

SecurityException

Kod z częściowym zaufaniem wywołuje metodę , ale zapisuje w odbiorniku dziennika zdarzeń, który wymaga pełnego zaufania.

Przykłady

W tym przykładzie pokazano, jak używać metody do rejestrowania My.Application.Log.WriteException wyjątków. Usuń znaczniki komentarza Dim i, MsgBox aby spowodować NullReferenceException wyjątek. Aby uzyskać więcej informacji, zobacz Instrukcje: wyjątki dzienników.

Public Sub ExceptionLogTest(ByVal fileName As String)
    Try
        ' Code that might generate an exception goes here.
        ' For example:
        '    Dim x As Object
        '    MsgBox(x.ToString)
    Catch ex As Exception
        My.Application.Log.WriteException(ex, 
            TraceEventType.Error, 
            "Exception in ExceptionLogTest " & 
            "with argument " & fileName & ".")
    End Try
End Sub

Ten przykładowy kod może działać tylko w aplikacji klienckiej. Zmień My.Application.Log.WriteException wartość na My.Log.WriteException dla aplikacji internetowych.

Uwagi

Metoda WriteException zapisuje informacje zawarte w wyjątku do odbiorników dziennika zdarzeń aplikacji.

W aplikacjach klienckich Log obiekt jest dostępny za pośrednictwem My.Application.Log obiektu . W aplikacjach Log internetowych obiekt jest dostępny za pośrednictwem My.Log obiektu .

Aby dowiedzieć się, które odbiorniki dzienników odbierają WriteException komunikaty metody, zobacz Przewodnik: określanie miejsca zapisu informacji w pliku My.Application.Log. Możesz zmienić domyślne odbiorniki dziennika. Aby uzyskać więcej informacji, zobacz Praca z dziennikami aplikacji.

W przypadku przeciążeń, które nie przyjmują argumentu id , identyfikator zapisany w dzienniku jest definiowany przez poniższą tabelę.

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

W poniższej tabeli wymieniono przykłady zadań obejmujących metodę WriteException .

Działanie	Zobacz
Zapisuj informacje o wyjątkach do odbiorników dziennika zdarzeń aplikacji.	Instrukcje: rejestrowanie wyjątków
Ustal, gdzie Log zapisuje informacje.	Przewodnik: ustalanie lokalizacji, w której element My.Application.Log zapisuje informacje

Dostępność według typu projektu

Project type (Typ projektu)	Dostępne
Aplikacja systemu Windows	Tak
Biblioteka klas	Tak
Aplikacja konsoli	Tak
Biblioteka kontrolek systemu Windows	Tak
Biblioteka formantów sieci Web	Nie
Usługa systemu Windows	Tak
Witryna sieci Web	Tak

Zobacz też

• Exception
• TraceEventType
• Obiekty (Visual Basic)
• Praca z dziennikami aplikacji w Visual Basic
• Porady: wyjątki rejestru w Visual Basic
• Przewodnik: ustalanie lokalizacji, w której element My.Application.Log zapisuje informacje

WriteException(Exception, TraceEventType, String)

Zapisuje informacje o wyjątkach do odbiorników dzienników aplikacji.

public:
 void WriteException(Exception ^ ex, System::Diagnostics::TraceEventType severity, System::String ^ additionalInfo);

public void WriteException (Exception ex, System.Diagnostics.TraceEventType severity, string additionalInfo);

member this.WriteException : Exception * System.Diagnostics.TraceEventType * string -> unit

Public Sub WriteException (ex As Exception, severity As TraceEventType, additionalInfo As String)

Parametry

ex

Exception

Wymagane. Wyjątek do rejestrowania.

severity

TraceEventType

Typ komunikatu. Domyślnie Error.

additionalInfo

String

Ciąg do dołączenia do wiadomości. Domyślnie jest to pusty ciąg.

Wyjątki

ArgumentNullException

ex to Nothing.

InvalidEnumArgumentException

Typ komunikatu TraceEventType nie jest jedną z wartości wyliczenia.

SecurityException

Kod z częściowym zaufaniem wywołuje metodę , ale zapisuje w odbiorniku dziennika zdarzeń, który wymaga pełnego zaufania.

Przykłady

W tym przykładzie pokazano, jak używać metody do rejestrowania My.Application.Log.WriteException wyjątków. Usuń znaczniki komentarza Dim i, MsgBox aby spowodować NullReferenceException wyjątek. Aby uzyskać więcej informacji, zobacz Instrukcje: wyjątki dzienników.

Public Sub ExceptionLogTest(ByVal fileName As String)
    Try
        ' Code that might generate an exception goes here.
        ' For example:
        '    Dim x As Object
        '    MsgBox(x.ToString)
    Catch ex As Exception
        My.Application.Log.WriteException(ex, 
            TraceEventType.Error, 
            "Exception in ExceptionLogTest " & 
            "with argument " & fileName & ".")
    End Try
End Sub

Ten przykładowy kod może działać tylko w aplikacji klienckiej. Zmień My.Application.Log.WriteException wartość na My.Log.WriteException dla aplikacji internetowych.

Uwagi

Metoda WriteException zapisuje informacje zawarte w wyjątku do odbiorników dziennika zdarzeń aplikacji.

W aplikacjach klienckich Log obiekt jest dostępny za pośrednictwem My.Application.Log obiektu . W aplikacjach Log internetowych obiekt jest dostępny za pośrednictwem My.Log obiektu .

Aby dowiedzieć się, które odbiorniki dzienników odbierają WriteException komunikaty metody, zobacz Przewodnik: określanie miejsca zapisu informacji w pliku My.Application.Log. Możesz zmienić domyślne odbiorniki dziennika. Aby uzyskać więcej informacji, zobacz Praca z dziennikami aplikacji.

W przypadku przeciążeń, które nie przyjmują argumentu id , identyfikator zapisany w dzienniku jest definiowany przez poniższą tabelę.

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

W poniższej tabeli wymieniono przykłady zadań obejmujących metodę WriteException .

Działanie	Zobacz
Zapisz informacje o wyjątkach do odbiorników dziennika zdarzeń aplikacji.	Instrukcje: rejestrowanie wyjątków
Ustal, gdzie Log zapisuje informacje.	Przewodnik: ustalanie lokalizacji, w której element My.Application.Log zapisuje informacje

Dostępność według typu projektu

Project type (Typ projektu)	Dostępne
Aplikacja systemu Windows	Tak
Biblioteka klas	Tak
Aplikacja konsoli	Tak
Biblioteka kontrolek systemu Windows	Tak
Biblioteka formantów sieci Web	Nie
Usługa systemu Windows	Tak
Witryna sieci Web	Tak

Zobacz też

• Exception
• TraceEventType
• Obiekty (Visual Basic)
• Praca z dziennikami aplikacji w Visual Basic
• Porady: wyjątki rejestru w Visual Basic
• Przewodnik: ustalanie lokalizacji, w której element My.Application.Log zapisuje informacje

WriteException(Exception, TraceEventType, String, Int32)

Zapisuje informacje o wyjątkach do odbiorników dzienników aplikacji.

public:
 void WriteException(Exception ^ ex, System::Diagnostics::TraceEventType severity, System::String ^ additionalInfo, int id);

public void WriteException (Exception ex, System.Diagnostics.TraceEventType severity, string additionalInfo, int id);

member this.WriteException : Exception * System.Diagnostics.TraceEventType * string * int -> unit

Public Sub WriteException (ex As Exception, severity As TraceEventType, additionalInfo As String, id As Integer)

Parametry

ex

Exception

Wymagane. Wyjątek do rejestrowania.

severity

TraceEventType

Typ komunikatu. Domyślnie Error.

additionalInfo

String

Ciąg do dołączenia do komunikatu. Domyślnie jest to pusty ciąg.

id

Int32

Identyfikator komunikatu, zazwyczaj używany do korelacji. Domyślnie powiązane z entryType opisem w tabeli w sekcji Uwagi.

Wyjątki

ArgumentNullException

ex to Nothing.

InvalidEnumArgumentException

Typ komunikatu TraceEventType nie jest jedną z wartości wyliczenia.

SecurityException

Kod z częściowym zaufaniem wywołuje metodę, ale zapisuje w odbiorniku dziennika zdarzeń, który wymaga pełnego zaufania.

Przykłady

W tym przykładzie pokazano, jak używać metody do rejestrowania My.Application.Log.WriteException wyjątków. Usuń komentarz z wierszy Dim i MsgBox , aby spowodować NullReferenceException wyjątek. Aby uzyskać więcej informacji, zobacz Instrukcje: wyjątki dziennika.

Public Sub ExceptionLogTest(ByVal fileName As String)
    Try
        ' Code that might generate an exception goes here.
        ' For example:
        '    Dim x As Object
        '    MsgBox(x.ToString)
    Catch ex As Exception
        My.Application.Log.WriteException(ex, 
            TraceEventType.Error, 
            "Exception in ExceptionLogTest " & 
            "with argument " & fileName & ".")
    End Try
End Sub

Ten przykład kodu może działać tylko w aplikacji klienckiej. Zmień wartość My.Application.Log.WriteException na My.Log.WriteException dla aplikacji internetowych.

Uwagi

Metoda WriteException zapisuje informacje zawarte w wyjątku dla odbiorników dziennika zdarzeń aplikacji.

W aplikacjach klienckich Log obiekt jest dostępny za pośrednictwem My.Application.Log obiektu. W aplikacjach Log internetowych obiekt jest dostępny za pośrednictwem My.Log obiektu.

Aby dowiedzieć się, które odbiorniki dzienników odbierają WriteException komunikaty metody, zobacz Przewodnik: określanie miejsca zapisu informacji my.application.log. Można zmienić domyślne odbiorniki dziennika. Aby uzyskać więcej informacji, zobacz Praca z dziennikami aplikacji.

W przypadku przeciążeń, które nie przyjmują argumentu, identyfikator zapisany w dzienniku id jest zdefiniowany w poniższej tabeli.

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

W poniższej tabeli wymieniono przykłady zadań obejmujących metodę WriteException .

Działanie	Zobacz
Zapisz informacje o wyjątkach do odbiorników dziennika zdarzeń aplikacji.	Instrukcje: rejestrowanie wyjątków
Ustal, gdzie Log zapisuje informacje.	Przewodnik: ustalanie lokalizacji, w której element My.Application.Log zapisuje informacje

Dostępność według typu projektu

Project type (Typ projektu)	Dostępne
Aplikacja systemu Windows	Tak
Biblioteka klas	Tak
Aplikacja konsoli	Tak
Biblioteka kontrolek systemu Windows	Tak
Biblioteka formantów sieci Web	Nie
Usługa systemu Windows	Tak
Witryna sieci Web	Tak

Zobacz też

• Exception
• TraceEventType
• Obiekty (Visual Basic)
• Praca z dziennikami aplikacji w Visual Basic
• Porady: wyjątki rejestru w Visual Basic
• Przewodnik: ustalanie lokalizacji, w której element My.Application.Log zapisuje informacje