EventLogTraceListener Класс

Определение

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

System.Diagnostics

Сборка:

System.Diagnostics.EventLog.dll

Пакет:

System.Diagnostics.EventLog v8.0.0

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

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 объект .

int main()
{
   #if defined(TRACE)
   
   // Create a trace listener for the event log.
   EventLogTraceListener^ myTraceListener = 
      gcnew 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" );
   
   #endif
}

// 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.Listenersколлекции , Trace.Listenersили TraceSource.Listeners для отправки выходных данных трассировки или отладки в коллекцию EventLog. Вы можете добавить экземпляр в код или указать его в файле конфигурации приложения для платформа .NET Framework.

Чтобы добавить EventLogTraceListener с помощью платформа .NET Framework файла конфигурации приложения, измените файл, соответствующий имени приложения. В этом файле вставьте элемент для System.Diagnostics.EventLogTraceListener типа. В следующем примере в коллекцию EventLogTraceListener добавляется объект с Trace.Listeners именем myListener . Параметр 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 закрывает журнал событий, чтобы больше не получать выходные данные трассировки или отладки. Методы Write и WriteLine записывают сообщение в журнал событий.

Примечание

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

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

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

Свойства

Attributes	Возвращает настраиваемые атрибуты прослушивателя трассировки, определенные в файле конфигурации приложения. (Унаследовано от TraceListener)
EventLog	Получает или задает журнал событий для записи.
Filter	Получает или задает фильтр трассировки для прослушивателя трассировки. (Унаследовано от TraceListener)
IndentLevel	Возвращает или задает уровень отступа. (Унаследовано от TraceListener)
IndentSize	Возвращает или задает число пробелов в отступе. (Унаследовано от TraceListener)
IsThreadSafe	Возвращает значение, указывающее, является ли прослушиватель трассировки потокобезопасным. (Унаследовано от TraceListener)
Name	Получает или задает имя данного объекта EventLogTraceListener.
NeedIndent	Возвращает или задает значение, указывающее, нужен ли отступ в выходных данных. (Унаследовано от TraceListener)
TraceOutputOptions	Возвращает или задает параметры выходных данных трассировки. (Унаследовано от TraceListener)

Методы

Close()	Закрывает журнал событий; таким образом журнал больше не получает выходных данных трассировки или отладки.
CreateObjRef(Type)	Создает объект, который содержит всю необходимую информацию для создания прокси-сервера, используемого для взаимодействия с удаленным объектом. (Унаследовано от MarshalByRefObject)
Dispose()	Освобождает все ресурсы, занятые модулем TraceListener. (Унаследовано от TraceListener)
Dispose(Boolean)	Освобождает неуправляемые ресурсы, используемые объектом TraceListener, а при необходимости освобождает также управляемые ресурсы. (Унаследовано от TraceListener)
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
Fail(String)	Посылает сообщение об ошибке в прослушиватель, создаваемый при реализации класса TraceListener. (Унаследовано от TraceListener)
Fail(String, String)	Выдает простое и подробное сообщение об ошибке в прослушиватель, создаваемый при реализации класса TraceListener. (Унаследовано от TraceListener)
Flush()	Если переопределено в производном классе, очищает выходной буфер. (Унаследовано от TraceListener)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetLifetimeService()	Извлекает объект обслуживания во время существования, который управляет политикой времени существования данного экземпляра. (Унаследовано от MarshalByRefObject)
GetSupportedAttributes()	Возвращает настраиваемые атрибуты, поддерживаемые прослушивателем трассировки. (Унаследовано от TraceListener)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
InitializeLifetimeService()	Получает объект службы времени существования для управления политикой времени существования для этого экземпляра. (Унаследовано от MarshalByRefObject)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
MemberwiseClone(Boolean)	Создает неполную копию текущего объекта MarshalByRefObject. (Унаследовано от MarshalByRefObject)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)
TraceData(TraceEventCache, String, TraceEventType, Int32, Object)	Записывает информацию трассировки, объект данных и информацию о событиях в журнал событий.
TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])	Записывает информацию трассировки, массив объектов данных и информацию о событиях в журнал событий.
TraceEvent(TraceEventCache, String, TraceEventType, Int32)	Записывает сведения трассировки и сведения о событиях в специальные выходные данные прослушивателя. (Унаследовано от TraceListener)
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)	Записывает информацию трассировки, сообщение и информацию о событиях в журнал событий.
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])	Записывает информацию трассировки, форматированный массив объектов и информацию о событиях в журнал событий.
TraceTransfer(TraceEventCache, String, Int32, String, Guid)	Записывает сведения трассировки, сообщение, идентификатор сопутствующего действия и сведения о событиях в специальные выходные данные прослушивателя. (Унаследовано от TraceListener)
Write(Object)	Записывает значение метода ToString() объекта в прослушиватель, создаваемый при реализации класса TraceListener. (Унаследовано от TraceListener)
Write(Object, String)	Записывает имя категории и значение метода ToString() объекта в прослушиватель, создаваемый при реализации класса TraceListener. (Унаследовано от TraceListener)
Write(String)	Записывает сообщение в журнал событий для данного экземпляра.
Write(String, String)	Записывает имя категории и сообщение в прослушиватель, создаваемый при реализации класса TraceListener. (Унаследовано от TraceListener)
WriteIndent()	Записывает отступ в прослушиватель, создаваемый при реализации этого класса, и восстанавливает для свойства NeedIndent значение false. (Унаследовано от TraceListener)
WriteLine(Object)	Записывает значение метода ToString() объекта, заканчивающееся знаком завершения строки, в прослушиватель, создаваемый при реализации класса TraceListener. (Унаследовано от TraceListener)
WriteLine(Object, String)	Записывает имя категории и значение метода ToString() объекта, заканчивающееся знаком завершения строки, в прослушиватель, создаваемый при реализации класса TraceListener. (Унаследовано от TraceListener)
WriteLine(String)	Записывает сообщение в журнал событий для данного экземпляра.
WriteLine(String, String)	Записывает имя категории и сообщение, заканчивающееся знаком завершения строки, в прослушиватель, создаваемый при реализации класса TraceListener. (Унаследовано от TraceListener)

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

Данный тип потокобезопасен.

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

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