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


Метод 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 по умолчанию

Information

0

Warning

1

Error

2

Critical

3

Start

4

Stop

5

Suspend

6

Resume

7

Verbose

8

Transfer

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

Да

Веб-узел

Да

Разрешения

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

Разрешение

Описание

FileIOPermission

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

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

См. также

Задачи

Практическое руководство. Запись сообщений в журнал

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

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

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

Ссылки

Объект My.Application.Log

Объект My.Log

System.Diagnostics.TraceEventType

Log.WriteEntry