Log.WriteException Metoda

Odwołanie

Definicja

Przestrzeń nazw:: Microsoft.VisualBasic.Logging

Zestaw:: Microsoft.VisualBasic.dll

Zestaw:: Microsoft.VisualBasic.Forms.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

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

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 .

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

Sprzężenie zwrotne

Czy ta strona była pomocna?

Udostępnij przez

Log.WriteException Metoda

Definicja

Przeciążenia

WriteException(Exception)

Parametry

Wyjątki

Przykłady

Uwagi

Dostępność według typu projektu

Zobacz też

Dotyczy

WriteException(Exception, TraceEventType, String)

Parametry

Wyjątki

Przykłady

Uwagi

Dostępność według typu projektu

Zobacz też

Dotyczy

WriteException(Exception, TraceEventType, String, Int32)

Parametry

Wyjątki

Przykłady

Uwagi

Dostępność według typu projektu

Zobacz też

Dotyczy

Sprzężenie zwrotne