Log.WriteException Метод

Определение

Пространство имен:: Microsoft.VisualBasic.Logging

Сборка:: Microsoft.VisualBasic.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Записывает сведения об исключении в прослушиватели журналов приложения.

Перегрузки

Имя	Описание
WriteException(Exception)	Записывает сведения об исключении в прослушиватели журналов приложения.
WriteException(Exception, TraceEventType, String)	Записывает сведения об исключении в прослушиватели журналов приложения.
WriteException(Exception, TraceEventType, String, Int32)	Записывает сведения об исключении в прослушиватели журналов приложения.

WriteException(Exception)

Записывает сведения об исключении в прослушиватели журналов приложения.

public:
 void WriteException(Exception ^ ex);

public void WriteException(Exception ex);

member this.WriteException : Exception -> unit

Public Sub WriteException (ex As Exception)

Параметры

ex: Exception

Обязательно. Исключение для журнала.

Исключения

ArgumentNullException

ex равно Nothing.

SecurityException

Код с частичным доверием вызывает метод, но записывает в прослушиватель журнала событий, требующий полного доверия.

Примеры

В этом примере показано, как использовать My.Application.Log.WriteException метод для регистрации исключений. Раскомментируйте Dim и MsgBox строки, чтобы вызвать NullReferenceException исключение. Дополнительные сведения см. в разделе "Практическое руководство. Исключения журналов".

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

Этот пример кода может выполняться только в клиентском приложении. Перейдите My.Application.Log.WriteException на My.Log.WriteException веб-приложения.

Сведения о том, какие прослушиватели журналов получают WriteException сообщения метода, см. в пошаговом руководстве. Определение места записи данных My.Application.Log. Прослушиватели журналов по умолчанию можно изменить. Дополнительные сведения см. в статье "Работа с журналами приложений".

Для перегрузок, которые не принимают id аргумент, идентификатор, записанный в журнал, определяется следующей таблицей.

`severity`	`id` по умолчанию
Information	0
Warning	1
Error	2
Critical	3
Start	4
Stop	5
Suspend	6
Resume	7
Verbose	8
Transfer	9

В следующей таблице перечислены примеры задач, связанных с методом WriteException .

Кому	Смотри
Запись сведений об исключении в прослушиватели журналов событий приложения.	Практическое руководство: Регистрация исключений
Определите место `Log` записи сведений.	Пошаговое руководство: определение места записи сведений в my.Application.Log

Доступность по типу проекта

тип проекта	В наличии
Приложение Windows	Yes
Библиотека классов	Yes
Консольное приложение	Yes
Библиотека элементов управления Windows	Yes
Библиотека веб-элементов управления	Нет
Службы Windows	Yes
Веб-сайт	Yes

См. также раздел

Применяется к

WriteException(Exception, TraceEventType, String)

Записывает сведения об исключении в прослушиватели журналов приложения.

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)

Параметры

ex: Exception

Обязательно. Исключение для журнала.

severity: TraceEventType

Тип сообщения. По умолчанию Error.

additionalInfo: String

Строка, добавляемая к сообщению. По умолчанию это пустая строка.

Исключения

ArgumentNullException

ex равно Nothing.

InvalidEnumArgumentException

Тип сообщения не является одним из значений TraceEventType перечисления.

SecurityException

Примеры

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

Кому	Смотри
Запись сведений об исключении в прослушиватели журналов событий приложения.	Практическое руководство: Регистрация исключений
Определите место `Log` записи сведений.	Пошаговое руководство: определение места записи сведений в my.Application.Log

Доступность по типу проекта

тип проекта	В наличии
Приложение Windows	Yes
Библиотека классов	Yes
Консольное приложение	Yes
Библиотека элементов управления Windows	Yes
Библиотека веб-элементов управления	Нет
Службы Windows	Yes
Веб-сайт	Yes

См. также раздел

Применяется к

WriteException(Exception, TraceEventType, String, Int32)

Записывает сведения об исключении в прослушиватели журналов приложения.

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)

Параметры

ex: Exception

Обязательно. Исключение для журнала.

severity: TraceEventType

Тип сообщения. По умолчанию Error.

additionalInfo: String

Строка, добавляемая к сообщению. По умолчанию это пустая строка.

id: Int32

Идентификатор сообщения, обычно используемый для корреляции. По умолчанию, связанная с entryType описанием таблицы в разделе "Примечания".

Исключения

ArgumentNullException

ex равно Nothing.

InvalidEnumArgumentException

Тип сообщения не является одним из значений TraceEventType перечисления.

SecurityException

Примеры

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

Кому	Смотри
Запись сведений об исключении в прослушиватели журналов событий приложения.	Практическое руководство: Регистрация исключений
Определите место `Log` записи сведений.	Пошаговое руководство: определение места записи сведений в my.Application.Log

Доступность по типу проекта

тип проекта	В наличии
Приложение Windows	Yes
Библиотека классов	Yes
Консольное приложение	Yes
Библиотека элементов управления Windows	Yes
Библиотека веб-элементов управления	Нет
Службы Windows	Yes
Веб-сайт	Yes

См. также раздел

Применяется к

Обратная связь

Были ли сведения на этой странице полезными?

Log.WriteException Метод

Определение

Перегрузки

WriteException(Exception)

Параметры

Исключения

Примеры

Комментарии

Доступность по типу проекта

См. также раздел

Применяется к

WriteException(Exception, TraceEventType, String)

Параметры

Исключения

Примеры

Комментарии

Доступность по типу проекта

См. также раздел

Применяется к

WriteException(Exception, TraceEventType, String, Int32)

Параметры

Исключения

Примеры

Комментарии

Доступность по типу проекта

См. также раздел

Применяется к