Log.WriteException Metoda

Definicja

Przestrzeń nazw:

Microsoft.VisualBasic.Logging

Zestaw:

Microsoft.VisualBasic.dll

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

Przeciążenia

Nazwa	Opis
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

To jest wymagane. Wyjątek do rejestrowania.

Wyjątki

ArgumentNullException

Parametr ex ma wartość 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ń komentarz z wierszy Dim i MsgBox , aby spowodować wyjątek NullReferenceException . Aby uzyskać więcej informacji, zobacz Instrukcje: wyjątki dziennika.

Private Sub GetOpenFormTitles()
    Dim formTitles As New Collection

    Try
        For Each f As Form In My.Application.OpenForms
            If Not f.InvokeRequired Then
                ' Can access the form directly.
                formTitles.Add(f.Text)
            End If
        Next
    Catch ex As Exception
        formTitles.Add("Error: " & ex.Message)
    End Try

    Form1.ListBox1.DataSource = formTitles
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, gdzie my.Application.Log zapisuje informacje. 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 definiowany przez poniższą tabelę.

severity	id domyślne
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 .

Do	Zobacz
Zapisuj informacje o wyjątkach do odbiorników dziennika zdarzeń aplikacji.	Instrukcje: rejestrowanie wyjątków
Ustal, gdzie Log zapisuje informacje.	Przewodnik: określanie miejsca, w którym my.Application.Log zapisuje informacje

Dostępność według typu projektu

Rodzaj projektu	Available
Aplikacja systemu Windows	Yes
Biblioteka klas	Yes
Aplikacja konsolowa	Yes
Biblioteka kontrolek systemu Windows	Yes
Biblioteka kontrolek sieci Web	No
Usługa systemu Windows	Yes
Witryna sieci Web	Yes

Zobacz też

• Exception
• TraceEventType
• Obiekty (Visual Basic)
• Praca z dziennikami aplikacji w Visual Basic
• Jak: Rejestrowanie wyjątków w Visual Basic
• Przewodnik: określanie miejsca, w którym my.Application.Log zapisuje informacje

WriteException(Exception, TraceEventType, String)

Zapisuje informacje o wyjątkach do odbiorników dziennika 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

To jest wymagane. Wyjątek do rejestrowania.

severity

TraceEventType

Typ wiadomości. Domyślnie Error.

additionalInfo

String

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

Wyjątki

ArgumentNullException

Parametr ex ma wartość 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ć wyjątek NullReferenceException . Aby uzyskać więcej informacji, zobacz Instrukcje: wyjątki dziennika.

Private Sub GetOpenFormTitles()
    Dim formTitles As New Collection

    Try
        For Each f As Form In My.Application.OpenForms
            If Not f.InvokeRequired Then
                ' Can access the form directly.
                formTitles.Add(f.Text)
            End If
        Next
    Catch ex As Exception
        formTitles.Add("Error: " & ex.Message)
    End Try

    Form1.ListBox1.DataSource = formTitles
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, gdzie my.Application.Log zapisuje informacje. 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 definiowany przez poniższą tabelę.

severity	id domyślne
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 .

Do	Zobacz
Zapisuj informacje o wyjątkach do odbiorników dziennika zdarzeń aplikacji.	Instrukcje: rejestrowanie wyjątków
Ustal, gdzie Log zapisuje informacje.	Przewodnik: określanie miejsca, w którym my.Application.Log zapisuje informacje

Dostępność według typu projektu

Rodzaj projektu	Available
Aplikacja systemu Windows	Yes
Biblioteka klas	Yes
Aplikacja konsolowa	Yes
Biblioteka kontrolek systemu Windows	Yes
Biblioteka kontrolek sieci Web	No
Usługa systemu Windows	Yes
Witryna sieci Web	Yes

Zobacz też

• Exception
• TraceEventType
• Obiekty (Visual Basic)
• Praca z dziennikami aplikacji w Visual Basic
• Jak: Rejestrowanie wyjątków w Visual Basic
• Przewodnik: określanie miejsca, w którym my.Application.Log zapisuje informacje

WriteException(Exception, TraceEventType, String, Int32)

Zapisuje informacje o wyjątkach do odbiorników dziennika 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

To jest wymagane. Wyjątek do rejestrowania.

severity

TraceEventType

Typ wiadomości. Domyślnie Error.

additionalInfo

String

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

id

Int32

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

Wyjątki

ArgumentNullException

Parametr ex ma wartość 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ć wyjątek NullReferenceException . Aby uzyskać więcej informacji, zobacz Instrukcje: wyjątki dziennika.

Private Sub GetOpenFormTitles()
    Dim formTitles As New Collection

    Try
        For Each f As Form In My.Application.OpenForms
            If Not f.InvokeRequired Then
                ' Can access the form directly.
                formTitles.Add(f.Text)
            End If
        Next
    Catch ex As Exception
        formTitles.Add("Error: " & ex.Message)
    End Try

    Form1.ListBox1.DataSource = formTitles
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, gdzie my.Application.Log zapisuje informacje. 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 definiowany przez poniższą tabelę.

severity	id domyślne
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 .

Do	Zobacz
Zapisuj informacje o wyjątkach do odbiorników dziennika zdarzeń aplikacji.	Instrukcje: rejestrowanie wyjątków
Ustal, gdzie Log zapisuje informacje.	Przewodnik: określanie miejsca, w którym my.Application.Log zapisuje informacje

Dostępność według typu projektu

Rodzaj projektu	Available
Aplikacja systemu Windows	Yes
Biblioteka klas	Yes
Aplikacja konsolowa	Yes
Biblioteka kontrolek systemu Windows	Yes
Biblioteka kontrolek sieci Web	No
Usługa systemu Windows	Yes
Witryna sieci Web	Yes

Zobacz też

• Exception
• TraceEventType
• Obiekty (Visual Basic)
• Praca z dziennikami aplikacji w Visual Basic
• Jak: Rejestrowanie wyjątków w Visual Basic
• Przewodnik: określanie miejsca, w którym my.Application.Log zapisuje informacje