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

Метод WriteException (My.Application.Log и My.Log)

  • Статья

Обновлен: Ноябрь 2007

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

' Usage
My.Application.Log.WriteException(ex)
My.Application.Log.WriteException(ex ,severity ,additionalInfo)
My.Application.Log.WriteException(ex ,severity ,additionalInfo ,id)
' Web usage
My.Log.WriteException(ex)
My.Log.WriteException(ex ,severity ,additionalInfo)
My.Log.WriteException(ex ,severity ,additionalInfo ,id)
' Declaration
Public Sub WriteException( _
   ByVal ex As System.Exception _
)
' -or-
Public Sub WriteException( _
   ByVal ex As System.Exception, _
   ByVal severity As System.Diagnostics.TraceEventType, _
   ByVal additionalInfo As String _
)
' -or-
Public Sub WriteException( _
   ByVal ex As System.Exception, _
   ByVal severity As System.Diagnostics.TraceEventType, _
   ByVal additionalInfo As String, _
   ByVal id As Integer _
)

Параметры

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

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

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

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

Исключения

В следующих случаях возникает исключение:

  • Исключение или сообщение относится к типу Nothing (ArgumentNullException).

  • Тип сообщения не является значением перечисления TraceEventType (InvalidEnumArgumentException).

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

Заметки

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

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

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

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

severity

id по умолчанию

Information

0

Warning

1

Error

2

Critical

3

Start

4

Stop

5

Suspend

6

Resume

7

Verbose

8

Transfer

9

Задачи

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

Задача

См.

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

Практическое руководство. Запись в журнал сведений об исключениях в Visual Basic

Определить место, куда объект Log записывает информацию.

Пошаговое руководство. Определение места записи информации для My.Application.Log

Пример

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

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.

Требования

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

Класс:Log

**Сборка:**Visual Basic (библиотека времени выполнения, в Microsoft.VisualBasic.dll)

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

Тип проекта

Доступность

Приложение Windows

Да

Библиотека классов

Да

Консольное приложение

Да

Библиотека элементов управления Windows

Да

Библиотека веб-элементов управления

Нет

Служба Windows

Да

Веб-узел

Да

Разрешения

Могут потребоваться следующие разрешения:

Разрешение

Описание

FileIOPermission

Определяет возможность обращения к файлам или папкам. Связанное перечисление: Unrestricted.

Дополнительные сведения см. в разделах Управление доступом для кода и Запрос разрешений.

См. также

Задачи

Практическое руководство. Запись в журнал сведений об исключениях в Visual Basic

Пошаговое руководство. Определение места записи информации для My.Application.Log

Основные понятия

Работа с журналами приложения в Visual Basic

Ссылки

Объект My.Application.Log

Объект My.Log

System.Exception

System.Diagnostics.TraceEventType

Log.WriteException