TraceListener 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
abstract 추적 및 디버그 출력을 모니터링하는 수신기에 대한 기본 클래스를 제공합니다.
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클래스 TextWriterTraceListener 및 클래스를 DefaultTraceListenerEventLogTraceListener 참조하세요.
추적 수신기를 사용하려면 추적 또는 디버깅을 사용하도록 설정해야 합니다. 다음 구문은 컴파일러 관련입니다. C# 또는 Visual Basic 이외의 컴파일러를 사용하는 경우 컴파일러에 대한 설명서를 참조하세요.
C#에서 디버깅을 사용하도록 설정하려면 코드를 컴파일할 때 컴파일러 명령줄에 플래그를 추가
/d:DEBUG하거나 파일 맨 위에 추가할#define DEBUG수 있습니다. Visual Basic에서 컴파일러 명령줄에 플래그를 추가/d:DEBUG=True합니다.C#에서 추적을 사용하도록 설정하려면 코드를 컴파일할 때 컴파일러 명령줄에 플래그를 추가
/d:TRACE하거나 파일 맨 위에 추가#define TRACE합니다. Visual Basic에서 컴파일러 명령줄에 플래그를 추가/d:TRACE=True합니다.
추적 수신기를 추가하려면 애플리케이션의 이름에 해당하는 구성 파일을 편집합니다. 이 파일 내에서 수신기를 추가하거나, 해당 형식을 설정하고, 매개 변수를 설정하거나, 수신기를 제거하거나, 애플리케이션에서 이전에 설정한 모든 수신기를 지울 수 있습니다. 구성 파일의 형식은 다음 예제와 유사하게 지정해야 합니다.
<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를 참조<하세요>.
구현자 참고
이 클래스에서 상속하여 클래스 및 Trace 클래스에 대한 사용자 지정 수신기를 Debug 구현합니다. 최소한 해당 메서드와 WriteLine(String) 메서드를 Write(String) 구현해야 합니다. 또한 , Close() 및 Flush() 메서드를 구현할 Fail(String)수 있습니다.
생성자
| Name | Description |
|---|---|
| TraceListener() |
TraceListener 클래스의 새 인스턴스를 초기화합니다. |
| TraceListener(String) |
지정된 이름을 수신기로 사용하여 클래스의 TraceListener 새 인스턴스를 초기화합니다. |
속성
| Name | Description |
|---|---|
| Attributes |
애플리케이션 구성 파일에 정의된 사용자 지정 추적 수신기 특성을 가져옵니다. |
| Filter |
추적 수신기에 대한 추적 필터를 가져오거나 설정합니다. |
| IndentLevel |
들여쓰기 수준을 가져오거나 설정합니다. |
| IndentSize |
들여쓰기의 공백 수를 가져오거나 설정합니다. |
| IsThreadSafe |
추적 수신기가 스레드로부터 안전한지 여부를 나타내는 값을 가져옵니다. |
| Name |
이 TraceListener이름을 가져오거나 설정합니다. |
| NeedIndent |
출력을 들여쓰는지 여부를 나타내는 값을 가져오거나 설정합니다. |
| TraceOutputOptions |
추적 출력 옵션을 가져오거나 설정합니다. |
메서드
| Name | Description |
|---|---|
| Close() |
파생 클래스에서 재정의된 경우 더 이상 추적 또는 디버깅 출력을 받지 않도록 출력 스트림을 닫습니다. |
| CreateObjRef(Type) |
원격 개체와 통신하는 데 사용되는 프록시를 생성하는 데 필요한 모든 관련 정보를 포함하는 개체를 만듭니다. (다음에서 상속됨 MarshalByRefObject) |
| Dispose() |
에서 사용하는 모든 리소스를 TraceListener해제합니다. |
| Dispose(Boolean) |
관리되지 않는 리소스를 TraceListener 해제하고 관리되는 리소스를 선택적으로 해제합니다. |
| Equals(Object) |
지정한 개체와 현재 개체가 같은지 여부를 확인합니다. (다음에서 상속됨 Object) |
| Fail(String, String) |
클래스를 구현할 때 만든 수신기에 오류 메시지와 자세한 오류 메시지를 내보낸다 TraceListener . |
| Fail(String) |
클래스를 구현할 때 만든 수신기에 오류 메시지를 내보낸다 TraceListener . |
| Flush() |
파생 클래스에서 재정의되는 경우 출력 버퍼를 플러시합니다. |
| GetHashCode() |
기본 해시 함수로 작동합니다. (다음에서 상속됨 Object) |
| GetLifetimeService() |
이 인스턴스의 수명 정책을 제어하는 현재 수명 서비스 개체를 검색합니다. (다음에서 상속됨 MarshalByRefObject) |
| GetSupportedAttributes() |
추적 수신기에서 지원하는 사용자 지정 특성을 가져옵니다. |
| 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, String, Object[]) |
추적 정보, 형식이 지정된 개체 배열 및 이벤트 정보를 수신기별 출력에 씁니다. |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32, String) |
추적 정보, 메시지 및 이벤트 정보를 수신기별 출력에 씁니다. |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32) |
추적 및 이벤트 정보를 수신기별 출력에 씁니다. |
| TraceTransfer(TraceEventCache, String, Int32, String, Guid) |
추적 정보, 메시지, 관련 활동 ID 및 이벤트 정보를 수신기별 출력에 씁니다. |
| Write(Object, String) |
클래스를 구현 ToString() 할 때 만든 수신기에 범주 이름과 개체 메서드 값을 TraceListener 씁니다. |
| Write(Object) |
클래스를 구현 ToString() 할 때 만든 수신기에 개체 메서드의 TraceListener 값을 씁니다. |
| Write(String, String) |
클래스를 구현 TraceListener 할 때 만든 수신기에 범주 이름과 메시지를 씁니다. |
| Write(String) |
파생 클래스에서 재정의되는 경우 파생 클래스에서 만든 수신기에 지정된 메시지를 씁니다. |
| WriteIndent() |
이 클래스를 구현할 때 만든 수신기에 들여쓰기를 쓰고 속성을 NeedIndent다시 설정합니다 |
| WriteLine(Object, String) |
클래스를 구현 ToString() 할 때 만든 수신기에 범주 이름 및 개체 메서드의 TraceListener 값을 쓴 다음 줄 종결자를 씁니다. |
| WriteLine(Object) |
클래스를 구현 ToString() 할 때 만든 수신기에 개체 메서드의 TraceListener 값을 쓴 다음 줄 종결자를 씁니다. |
| WriteLine(String, String) |
클래스를 구현 TraceListener 할 때 만든 수신기에 범주 이름 및 메시지를 쓴 다음 줄 종결자를 씁니다. |
| WriteLine(String) |
파생 클래스에서 재정의된 경우 파생 클래스에서 만든 수신기에 메시지를 쓴 다음 줄 종결자를 씁니다. |
적용 대상
스레드 보안
이 형식은 스레드로부터 안전합니다.