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 -> unitPublic 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 | Да |
| Веб-сайт | Да |
См. также раздел
- Exception
- TraceEventType
- Объекты (Visual Basic)
- Работа с журналами приложения в Visual Basic
- Практическое руководство. Запись в журнал сведений об исключениях в Visual Basic
- Пошаговое руководство: Определение места записи сведений для My.Application.Log
Применяется к
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 -> unitPublic 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 | Да |
| Веб-сайт | Да |
См. также раздел
- Exception
- TraceEventType
- Объекты (Visual Basic)
- Работа с журналами приложения в Visual Basic
- Практическое руководство. Запись в журнал сведений об исключениях в Visual Basic
- Пошаговое руководство: Определение места записи сведений для My.Application.Log
Применяется к
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 -> unitPublic 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 | Да |
| Веб-сайт | Да |
См. также раздел
- Exception
- TraceEventType
- Объекты (Visual Basic)
- Работа с журналами приложения в Visual Basic
- Практическое руководство. Запись в журнал сведений об исключениях в Visual Basic
- Пошаговое руководство: Определение места записи сведений для My.Application.Log
Применяется к
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по