EventLogTraceListener Класс

Определение

Пространство имен:

System.Diagnostics

Сборка:

System.Diagnostics.EventLog.dll

Исходный код:

EventLogTraceListener.cs

Предоставляет простой прослушиватель, который направляет выходные данные трассировки или отладки в объект EventLog.

public ref class EventLogTraceListener sealed : System::Diagnostics::TraceListener

public sealed class EventLogTraceListener : System.Diagnostics.TraceListener

type EventLogTraceListener = class
    inherit TraceListener

Public NotInheritable Class EventLogTraceListener
Inherits TraceListener

Наследование

Object

MarshalByRefObject

TraceListener

EventLogTraceListener

Примеры

В следующем примере создается прослушиватель трассировки, который отправляет выходные данные в журнал событий. Во-первых, код создает новый EventLogTraceListener объект, использующий источник myEventLogSource. myTraceListener Затем добавляется в коллекциюTrace.Listeners. Наконец, в примере отправляется строка выходных данных объекту Listeners .

// Create a trace listener for the event log.
EventLogTraceListener myTraceListener = new EventLogTraceListener("myEventLogSource");

// Add the event log trace listener to the collection.
Trace.Listeners.Add(myTraceListener);

// Write output to the event log.
Trace.WriteLine("Test output");

Overloads Public Shared Sub Main(args() As String)
   
    ' Create a trace listener for the event log.
    Dim myTraceListener As New EventLogTraceListener("myEventLogSource")
    
    ' Add the event log trace listener to the collection.
    Trace.Listeners.Add(myTraceListener)
    
    ' Write output to the event log.
    Trace.WriteLine("Test output")
End Sub

Комментарии

Экземпляр этого EventLogTraceListener объекта можно добавить в Debug.ListenersTrace.Listenersколлекцию или TraceSource.Listeners коллекцию для отправки выходных данных из трассировки или отладки в объектEventLog. Экземпляр можно добавить в код или для приложения .NET Framework указать его в файле конфигурации приложения.

Чтобы добавить EventLogTraceListener файл конфигурации приложения .NET Framework, измените файл, соответствующий имени приложения. В этом файле вставьте элемент для System.Diagnostics.EventLogTraceListener типа. В следующем примере добавляется EventLogTraceListener объект с именем myListener в коллекцию Trace.Listeners . Параметр initializeData задает имя источника журнала событий, передаваемого конструктору EventLogTraceListener(String) .

<configuration>
  <system.diagnostics>
    <trace autoflush="false" indentsize="4">
      <listeners>
        <add name="myListener"
          type="System.Diagnostics.EventLogTraceListener"
          initializeData="TraceListenerLog" />
      </listeners>
    </trace>
  </system.diagnostics>
</configuration>

Замечание

Source Если журнал событий, связанный с EventLogTraceListener экземпляром, не существует, создается новый источник событий. Чтобы создать источник событий в Windows Vista, Windows XP Professional или Windows Server 2003, необходимо иметь права администратора.

Причина этого требования заключается в том, что все журналы событий, включая безопасность, необходимо выполнить поиск, чтобы определить, является ли источник события уникальным. В Windows Vista пользователи не имеют разрешения на доступ к журналу безопасности; SecurityException поэтому создается исключение.

В Windows Vista контроль учетных записей (UAC) определяет привилегии пользователя. Если вы являетесь членом встроенной группы "Администраторы", вы назначаете два маркера доступа во время выполнения: маркер доступа стандартного пользователя и маркер доступа администратора. По умолчанию вы находитесь в стандартной роли пользователя. Чтобы выполнить код, который обращается к журналу безопасности, необходимо сначала повысить привилегии от стандартного пользователя к администратору. Это можно сделать при запуске приложения, щелкнув правой кнопкой мыши значок приложения и указав, что вы хотите запустить от имени администратора.

Класс предоставляет EventLog свойство для получения или задания журнала событий, получающего выходные данные трассировки или отладки, а Name также свойство для хранения имени EventLogTraceListener.

Метод Close закрывает журнал событий, поэтому он больше не получает выходные данные трассировки или отладки. WriteLine Методы Write записывают сообщение в журнал событий.

Замечание

Чтобы избежать возможности записи больших объемов данных в журнал событий, не EventLogTraceListener выводит необязательные данные трассировки, указанные свойством TraceOutputOptions .

Конструкторы

Имя	Описание
EventLogTraceListener()	Инициализирует новый экземпляр EventLogTraceListener класса без прослушивателя трассировки.
EventLogTraceListener(EventLog)	Инициализирует новый экземпляр класса с помощью указанного EventLogTraceListener журнала событий.
EventLogTraceListener(String)	Инициализирует новый экземпляр класса с помощью указанного EventLogTraceListener источника.

Свойства

Имя	Описание
EventLog	Возвращает или задает журнал событий для записи.
Name	Возвращает или задает имя этого EventLogTraceListenerпараметра.

Методы

Имя	Описание
Close()	Закрывает журнал событий, чтобы он больше не получал выходные данные трассировки или отладки.
TraceData(TraceEventCache, String, TraceEventType, Int32, Object)	Записывает сведения трассировки, объект данных и сведения о событии в журнал событий.
TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])	Записывает сведения трассировки, массив объектов данных и сведения о событиях в журнал событий.
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])	Записывает сведения трассировки, форматированный массив объектов и сведения о событиях в журнал событий.
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)	Записывает сведения трассировки, сообщение и сведения о событии в журнал событий.
Write(String)	Записывает сообщение в журнал событий для этого экземпляра.
WriteLine(String)	Записывает сообщение в журнал событий для этого экземпляра.

Потокобезопасность

Этот тип является потокобезопасной.

См. также раздел

• TraceListener
• DefaultTraceListener
• TextWriterTraceListener
• EventLog
• Stream
• TextWriter
• Debug
• Trace