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


Log.WriteException Метод

Определение

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

Перегрузки

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

Обязательный. Исключение, подлежащее записи в журнал.

Исключения

ex имеет значение Nothing.

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

Примеры

В этом примере показано, как использовать 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 записывает сведения, содержащиеся в исключении, в прослушиватели журнала событий приложения.

В клиентских приложениях Log объект доступен через My.Application.Log объект . В веб-приложениях Log объект доступен через My.Log объект .

Сведения о том, какие прослушиватели журналов получают 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

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

Исключения

ex имеет значение Nothing.

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

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

Примеры

В этом примере показано, как использовать 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 записывает сведения, содержащиеся в исключении, в прослушиватели журнала событий приложения.

В клиентских приложениях Log объект доступен через My.Application.Log объект . В веб-приложениях Log объект доступен через My.Log объект .

Сведения о том, какие прослушиватели журналов получают 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, 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 , как описано в таблице в разделе Примечания.

Исключения

ex имеет значение Nothing.

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

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

Примеры

В этом примере показано, как использовать 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 записывает сведения, содержащиеся в исключении, в прослушиватели журнала событий приложения.

В клиентских приложениях Log объект доступен через My.Application.Log объект . В веб-приложениях Log объект доступен через My.Log объект .

Сведения о том, какие прослушиватели журналов получают 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 Да
Веб-сайт Да

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

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