Udostępnij za pośrednictwem

Log.WriteException Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
Microsoft.VisualBasic.Logging
Zestaw:
Microsoft.VisualBasic.dll
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ż

Dotyczy

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ż

Dotyczy

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ż

Dotyczy