Метод 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