EventLogTraceListener 클래스

정의

네임스페이스:

System.Diagnostics

어셈블리:

System.Diagnostics.EventLog.dll

패키지:

System.Diagnostics.EventLog v8.0.0

Source:

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

예제

다음 예제에서는 이벤트 로그에 출력을 보내는 추적 수신기를 만듭니다. 먼저 코드는 원본 myEventLogSource을 사용하는 새 EventLogTraceListener 를 만듭니다. 다음으로, 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 instance , Trace.Listeners또는 컬렉션에 Debug.Listeners추가하여 추적 또는 TraceSource.Listeners 디버깅에서 로 출력을 EventLog보낼 수 있습니다. 코드에 instance 추가하거나 .NET Framework 앱의 경우 애플리케이션 구성 파일에서 지정할 수 있습니다.

.NET Framework 애플리케이션 구성 파일을 사용하여 를 추가 EventLogTraceListener 하려면 애플리케이션 이름에 해당하는 파일을 편집합니다. 이 파일에서 형식에 대한 요소를 삽입합니다 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 instance 연결된 이벤트 로그에 EventLogTraceListener 대한 이 없으면 새 이벤트 원본이 만들어집니다. Windows Vista, Windows XP Professional 또는 Windows Server 2003에서 이벤트 원본을 만들려면 관리 권한이 있어야 합니다.

이 요구 사항의 이유는 보안을 포함한 모든 이벤트 로그를 검색하여 이벤트 원본이 고유한지 여부를 확인해야 하기 때문입니다. Windows Vista에서는 사용자에게 보안 로그에 액세스할 수 있는 권한이 없습니다. 따라서 가 SecurityException throw됩니다.

Windows Vista에서는 UAC(사용자 계정 컨트롤)가 사용자 권한을 결정합니다. 기본 제공 Administrators 그룹의 멤버인 경우 두 개의 런타임 액세스 토큰(표준 사용자 액세스 토큰 및 관리자 액세스 토큰)이 할당됩니다. 기본적으로 표준 사용자 역할이 지정됩니다. 보안 로그에 액세스하는 코드를 실행하려면 먼저 표준 사용자에서 관리자로 권한을 상승시켜야 합니다. 애플리케이션 아이콘을 마우스 오른쪽 단추로 클릭하고 관리자로 실행하도록 지정하여 애플리케이션을 시작하면 이 작업을 수행할 수 있습니다.

클래스는 추적 또는 디버깅 출력을 수신하는 이벤트 로그를 가져오기 또는 설정하는 속성과 Name 의 EventLogTraceListener이름을 보유할 속성을 제공합니다EventLog.

메서드는 Close 더 이상 추적 또는 디버깅 출력을 받지 않도록 이벤트 로그를 닫습니다. 및 WriteLine 메서드는 Write 이벤트 로그에 메시지를 씁니다.

참고

이벤트 로그에 대용량 데이터를 쓸 수 없도록 하려면 에서 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)	추적 정보, 메시지, 관련 작업 ID 및 이벤트 정보를 수신기별 출력에 씁니다. (다음에서 상속됨 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