TraceListener 클래스

정의

추적 및 디버그 출력을 모니터링하는 수신기의 abstract 기본 클래스를 제공합니다.Provides the abstract base class for the listeners who monitor trace and debug output.

public ref class TraceListener abstract : MarshalByRefObject, IDisposable
public abstract class TraceListener : MarshalByRefObject, IDisposable
type TraceListener = class
    inherit MarshalByRefObject
    interface IDisposable
Public MustInherit Class TraceListener
Inherits MarshalByRefObject
Implements IDisposable
상속
TraceListener
파생
구현

설명

구현 하는 방법에 대 한 예제는 TraceListener를 참조 합니다 DefaultTraceListener, TextWriterTraceListenerEventLogTraceListener 클래스.For examples of how to implement a TraceListener, see the DefaultTraceListener, TextWriterTraceListener and the EventLogTraceListener classes.

추적 수신기를 사용 하려면 추적 또는 디버깅을 활성화 해야 합니다.You must enable tracing or debugging to use a trace listener. 다음 구문은 특정 컴파일러입니다.The following syntax is compiler specific. C# 또는 Visual Basic 이외의 컴파일러를 사용 하면 컴파일러에 대 한 설명서를 참조 합니다.If you use compilers other than C# or Visual Basic, refer to the documentation for your compiler.

  • C# 디버깅을 사용 하려면 다음을 추가 합니다 /d:DEBUG 플래그를 추가할 수 있습니다 하거나 코드를 컴파일할 때 컴파일러 명령줄 #define DEBUG 파일의 맨 위로 이동 합니다.To enable debugging in C#, add the /d:DEBUG flag to the compiler command line when you compile your code, or you can add #define DEBUG to the top of your file. Visual Basic에서 추가 된 /d:DEBUG=True 컴파일러 명령줄 플래그입니다.In Visual Basic, add the /d:DEBUG=True flag to the compiler command line.

  • C#에서 추적을 사용 하려면 추가 합니다 /d:TRACE 코드를 컴파일할 때 컴파일러 명령줄 플래그 #define TRACE 파일의 맨 위로 이동 합니다.To enable tracing in C#, add the /d:TRACE flag to the compiler command line when you compile your code, or add #define TRACE to the top of your file. Visual Basic에서 추가 된 /d:TRACE=True 컴파일러 명령줄 플래그입니다.In Visual Basic, add the /d:TRACE=True flag to the compiler command line.

추적 수신기를 추가 하려면 애플리케이션의 이름에 해당 하는 구성 파일을 편집 합니다.To add a trace listener, edit the configuration file that corresponds to the name of your application. 이 파일에 수신기를 추가, 해당 형식을 설정 하 고 해당 매개 변수를 설정, 수신기를 제거 하거나 지울 수 애플리케이션에서 이전에 설정한 모든 수신기입니다.Within this file, you can add a listener, set its type and set its parameter, remove a listener, or clear all the listeners previously set by the application. 구성 파일을 다음 예제와 비슷한 형식을 지정 해야 합니다.The configuration file should be formatted similar to the following example.

<configuration>  
  <system.diagnostics>  
    <trace autoflush="false" indentsize="4">  
      <listeners>  
        <add name="myListener" type="System.Diagnostics.TextWriterTraceListener" initializeData="TextWriterOutput.log" />  
        <remove name="Default" />  
      </listeners>  
    </trace>  
  </system.diagnostics>  
</configuration>  

구성 파일을 사용 하 여 추적에 대 한 자세한 내용은 참조 하세요. <system.diagnostics>합니다.For more information on using configuration files for tracing, see <system.diagnostics>.

구현자 참고

에 대 한 사용자 지정 수신기를 구현 하려면이 클래스에서 상속 된 DebugTrace 클래스입니다.Inherit from this class to implement a custom listener for the Debug and Trace classes. 최소한를 구현 해야 합니다 Write(String)WriteLine(String) 메서드.At a minimum, you must implement the Write(String) and WriteLine(String) methods. 또한 구현할 수 있습니다 합니다 Fail(String), Close()Flush() 메서드.Additionally, you can implement the Fail(String), Close() and Flush() methods.

생성자

TraceListener()

TraceListener 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the TraceListener class.

TraceListener(String)

지정된 이름을 수신기로 사용하여 TraceListener의 새로운 인스턴스를 초기화합니다.Initializes a new instance of the TraceListener class using the specified name as the listener.

속성

Attributes

애플리케이션 구성 파일에 정의된 사용자 지정 추적 수신기 특성을 가져옵니다.Gets the custom trace listener attributes defined in the application configuration file.

Filter

추적 수신기의 추적 필터를 가져오거나 설정합니다.Gets or sets the trace filter for the trace listener.

IndentLevel

들여쓰기 수준을 가져오거나 설정합니다.Gets or sets the indent level.

IndentSize

들여쓰기의 공백 수를 가져오거나 설정합니다.Gets or sets the number of spaces in an indent.

IsThreadSafe

추적 수신기가 스레드로부터 안전한지 여부를 나타내는 값을 가져옵니다.Gets a value indicating whether the trace listener is thread safe.

Name

TraceListener의 이름을 가져오거나 설정합니다.Gets or sets a name for this TraceListener.

NeedIndent

출력의 들여쓰기 여부를 나타내는 값을 가져오거나 설정합니다.Gets or sets a value indicating whether to indent the output.

TraceOutputOptions

추적 출력 옵션을 가져오거나 설정합니다.Gets or sets the trace output options.

메서드

Close()

파생 클래스에서 재정의할 때 더 이상 추적 또는 디버깅 출력을 받지 않도록 출력 스트림을 닫습니다.When overridden in a derived class, closes the output stream so it no longer receives tracing or debugging output.

CreateObjRef(Type)

원격 개체와 통신하는 데 사용되는 프록시 생성에 필요한 모든 관련 정보가 들어 있는 개체를 만듭니다.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(다음에서 상속됨 MarshalByRefObject)
Dispose()

TraceListener에서 사용하는 모든 리소스를 해제합니다.Releases all resources used by the TraceListener.

Dispose(Boolean)

TraceListener에서 사용하는 관리되지 않는 리소스를 해제하고, 관리되는 리소스를 선택적으로 해제할 수 있습니다.Releases the unmanaged resources used by the TraceListener and optionally releases the managed resources.

Equals(Object)

지정한 개체와 현재 개체가 같은지 여부를 확인합니다.Determines whether the specified object is equal to the current object.

(다음에서 상속됨 Object)
Fail(String)

TraceListener 클래스를 구현할 때 생성한 수신기에 오류 메시지를 내보냅니다.Emits an error message to the listener you create when you implement the TraceListener class.

Fail(String, String)

TraceListener 클래스를 구현할 때 생성한 수신기에 자세한 오류 메시지를 내보냅니다.Emits an error message and a detailed error message to the listener you create when you implement the TraceListener class.

Flush()

파생 클래스에서 재정의할 때 출력 버퍼를 플러시합니다.When overridden in a derived class, flushes the output buffer.

GetHashCode()

기본 해시 함수로 작동합니다.Serves as the default hash function.

(다음에서 상속됨 Object)
GetLifetimeService()

이 인스턴스의 수명 정책을 제어하는 현재의 수명 서비스 개체를 검색합니다.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(다음에서 상속됨 MarshalByRefObject)
GetSupportedAttributes()

추적 수신기에서 지원하는 사용자 지정 특성을 가져옵니다.Gets the custom attributes supported by the trace listener.

GetType()

현재 인스턴스의 Type을 가져옵니다.Gets the Type of the current instance.

(다음에서 상속됨 Object)
InitializeLifetimeService()

이 인스턴스의 수명 정책을 제어하는 수명 서비스 개체를 가져옵니다.Obtains a lifetime service object to control the lifetime policy for this instance.

(다음에서 상속됨 MarshalByRefObject)
MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.Creates a shallow copy of the current Object.

(다음에서 상속됨 Object)
MemberwiseClone(Boolean)

현재 MarshalByRefObject 개체의 단순 복사본을 만듭니다.Creates a shallow copy of the current MarshalByRefObject object.

(다음에서 상속됨 MarshalByRefObject)
ToString()

현재 개체를 나타내는 문자열을 반환합니다.Returns a string that represents the current object.

(다음에서 상속됨 Object)
TraceData(TraceEventCache, String, TraceEventType, Int32, Object)

추적 정보, 데이터 개체 및 이벤트 정보를 수신기별 출력에 씁니다.Writes trace information, a data object and event information to the listener specific output.

TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])

추적 정보, 데이터 개체 배열 및 이벤트 정보를 수신기별 출력에 씁니다.Writes trace information, an array of data objects and event information to the listener specific output.

TraceEvent(TraceEventCache, String, TraceEventType, Int32)

추적 및 이벤트 정보를 수신기별 출력에 씁니다.Writes trace and event information to the listener specific output.

TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)

추적 정보, 메시지 및 이벤트 정보를 수신기별 출력에 씁니다.Writes trace information, a message, and event information to the listener specific output.

TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])

추적 정보, 형식 지정된 개체 배열 및 이벤트 정보를 수신기별 출력에 씁니다.Writes trace information, a formatted array of objects and event information to the listener specific output.

TraceTransfer(TraceEventCache, String, Int32, String, Guid)

추적 정보, 메시지 및 관련 작업 ID 및 이벤트 정보를 수신기별 출력에 씁니다.Writes trace information, a message, a related activity identity and event information to the listener specific output.

Write(Object)

ToString() 클래스를 구현할 때 생성한 수신기에 개체의 TraceListener 메서드 값을 씁니다.Writes the value of the object's ToString() method to the listener you create when you implement the TraceListener class.

Write(Object, String)

ToString() 클래스를 구현할 때 생성한 수신기에 범주 이름 및 개체의 TraceListener 메서드 값을 씁니다.Writes a category name and the value of the object's ToString() method to the listener you create when you implement the TraceListener class.

Write(String)

파생 클래스에서 재정의할 때 파생 클래스에서 생성한 수신기에 지정된 메시지를 씁니다.When overridden in a derived class, writes the specified message to the listener you create in the derived class.

Write(String, String)

TraceListener 클래스를 구현할 때 생성한 수신기에 범주 이름 및 메시지를 씁니다.Writes a category name and a message to the listener you create when you implement the TraceListener class.

WriteIndent()

이 클래스를 구현할 때 생성한 수신기에 들여쓰기를 하고 NeedIndent 속성을 false로 다시 설정합니다.Writes the indent to the listener you create when you implement this class, and resets the NeedIndent property to false.

WriteLine(Object)

ToString() 클래스를 구현할 때 생성한 수신기에 개체의 TraceListener 메서드 값을 쓴 다음 줄 종결자를 씁니다.Writes the value of the object's ToString() method to the listener you create when you implement the TraceListener class, followed by a line terminator.

WriteLine(Object, String)

ToString() 클래스를 구현할 때 생성한 수신기에 범주 이름 및 개체의 TraceListener 메서드 값을 쓴 다음 줄 종결자를 씁니다.Writes a category name and the value of the object's ToString() method to the listener you create when you implement the TraceListener class, followed by a line terminator.

WriteLine(String)

파생 클래스에서 재정의할 때 파생 클래스에서 생성한 수신기에 메시지를 쓴 다음 줄 종결자를 씁니다.When overridden in a derived class, writes a message to the listener you create in the derived class, followed by a line terminator.

WriteLine(String, String)

TraceListener 클래스를 구현할 때 생성한 수신기에 범주 이름 및 메시지를 쓴 다음 줄 종결자를 씁니다.Writes a category name and a message to the listener you create when you implement the TraceListener class, followed by a line terminator.

적용 대상

스레드 보안

이 형식은 스레드로부터 안전합니다.This type is thread safe.

추가 정보