Log.WriteException Метод

Ссылка

Определение

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

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

Сборка:: Microsoft.VisualBasic.Forms.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. Дополнительные сведения см. в разделе Практическое руководство. Журнал исключений.

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

Этот пример кода может выполняться только в клиентском приложении. Измените 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	Да
Библиотека классов	Да
Консольное приложение	Да
Библиотека элементов управления Windows	Да
Библиотека веб-элементов управления	Нет
Службы Windows	Да
Веб-сайт	Да

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

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

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

Примеры

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

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

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

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

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

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

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

Примеры

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

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

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

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

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

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

Поделиться через

Log.WriteException Метод

Определение

Перегрузки

WriteException(Exception)

Параметры

Исключения

Примеры

Комментарии

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

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

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

WriteException(Exception, TraceEventType, String)

Параметры

Исключения

Примеры

Комментарии

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

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

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

WriteException(Exception, TraceEventType, String, Int32)

Параметры

Исключения

Примеры

Комментарии

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

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

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

Дополнительные ресурсы