Метод WriteEntry (My.Application.Log и My.Log)
Обновлен: Ноябрь 2007
Записывает сообщение в журнал приложения.
' Usage
My.Application.Log.WriteEntry(message)
My.Application.Log.WriteEntry(message ,severity)
My.Application.Log.WriteEntry(message ,severity ,id)
' Web usage
My.Log.WriteEntry(message)
My.Log.WriteEntry(message ,severity)
My.Log.WriteEntry(message ,severity ,id)
' Declaration
Public Sub WriteEntry( _
ByVal message As String _
)
' -or-
Public Sub WriteEntry( _
ByVal message As String, _
ByVal severity As System.Diagnostics.TraceEventType _
)
' -or-
Public Sub WriteEntry( _
ByVal message As String, _
ByVal severity As System.Diagnostics.TraceEventType, _
ByVal id As Integer _
)
Параметры
message
Обязательный. Сообщение для записи в журнал. Если message является Nothing, то используется пустая строка.severity
Тип сообщения. По умолчанию — TraceEventType.Information.id
Идентификатор сообщения, обычно используемый для корреляции. По умолчанию связан с entryType, как описано в таблице.
Исключения
Следующие условия вызывают исключение:
Исключение или сообщение является типом Nothing (ArgumentNullException).
Тип сообщения не является значением перечисления TraceEventType (InvalidEnumArgumentException).
Код с частичным доверием вызывает метод, но выполняет запись в журнал событий, требующий полного доверия (SecurityException).
Заметки
Метод WriteEntry записывает сообщение в журнал событий приложения.
В клиентских приложениях объект Log доступен с помощью объекта My.Application.Log. В веб-приложениях объект Log доступен через объект My.Log.
Информация о том, в какие журналы записываются сообщения, вызываемые методом WriteEntry, см. в разделе Пошаговое руководство. Определение места записи информации для My.Application.Log. Можно изменить журнал, используемый по умолчанию. Дополнительные сведения см. в разделе Работа с журналами приложения в Visual Basic.
Для перегрузок, которые не принимают аргумент id, id записи в журнал определяется следующей таблицей.
severity |
id по умолчанию |
|---|---|
0 |
|
1 |
|
2 |
|
3 |
|
4 |
|
5 |
|
6 |
|
7 |
|
8 |
|
9 |
Задачи
В следующей таблице приведены примеры задач, в которых используется метод WriteEntry.
To |
См. разделы |
|---|---|
Запись сведений о событиях в журнал приложения |
|
Определение пути записи сведений для Log |
Пошаговое руководство. Определение места записи информации для My.Application.Log |
Пример
В этом примере показано использование метода My.Application.Log.WriteEntry для записи в журнал данных трассировки. Дополнительные сведения см. в разделе Практическое руководство. Запись сообщений в журнал.
Public Sub TracingTest(ByVal fileName As String)
My.Application.Log.WriteEntry( _
"Entering TracingTest with argument " & _
fileName & ".")
' Code to trace goes here.
My.Application.Log.WriteEntry( _
"Exiting TracingTest with argument " & _
fileName & ".")
End Sub
Данный пример кода может выполняться только в клиентском приложении. Для веб-приложений следует изменить My.Application.Log.WriteEntry на My.Log.WriteEntry.
Требования
Пространство имен:Microsoft.VisualBasic.Logging
Класс:Log
**Сборка:**Visual Basic (библиотека времени выполнения, в Microsoft.VisualBasic.dll)
Доступность по типу проекта
Тип проекта |
Доступность |
|---|---|
Приложение Windows |
Да |
Библиотека классов |
Да |
Консольное приложение |
Да |
Библиотека элементов управления Windows |
Да |
Библиотека веб-элементов управления |
Нет |
Служба Windows |
Да |
Веб-узел |
Да |
Разрешения
Могут потребоваться следующие разрешения:
Разрешение |
Описание |
|---|---|
Определяет возможность доступа к файлам или папкам. Связанное перечисление: Unrestricted. |
Дополнительные сведения см. в разделах Управление доступом для кода и Запрос разрешений.
См. также
Задачи
Практическое руководство. Запись сообщений в журнал
Пошаговое руководство. Определение места записи информации для My.Application.Log
Основные понятия
Работа с журналами приложения в Visual Basic