TextWriterTraceListener 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
추적 또는 디버깅 결과가 TextWriter과 같은 Stream이나 FileStream로 출력되도록 지정합니다.
public ref class TextWriterTraceListener : System::Diagnostics::TraceListenerpublic class TextWriterTraceListener : System.Diagnostics.TraceListenertype TextWriterTraceListener = class
inherit TraceListenerPublic Class TextWriterTraceListener
Inherits TraceListener- 상속
- 상속
- 파생
예제
다음 예제에서는 라는 파일에 TestFile.txt쓰기 위해 호출 myOutputWriter 을 StreamWriter 사용 하는 클래스의 TextWriterTraceListener instance 구현 합니다. 먼저 이 예제에서는 출력할 파일을 만듭니다. 그런 다음 첫 번째 텍스트 작성기에 대한 를 만들고 StreamWriter 출력 파일을 할당한 다음 에 추가합니다 Listeners. 그런 다음 코드는 한 줄의 텍스트를 파일에 출력합니다. 마지막으로 이 예제에서는 출력 버퍼를 플러시합니다.
이 샘플을 실행한 후 파일을 열어 TestFile.txt 출력을 볼 수 있습니다.
void main()
{
#if defined(TRACE)
// Create a file for output named TestFile.txt.
Stream^ myFile = File::Create( "TestFile.txt" );
// Create a new text writer using the output stream and
// add it to the trace listeners.
TextWriterTraceListener^ myTextListener =
gcnew TextWriterTraceListener( myFile );
Trace::Listeners->Add( myTextListener );
// Write output to the file.
Trace::Write( "Test output " );
// Flush the output.
Trace::Flush();
Trace::Close();
#endif
}
public class Sample
{
public static int Main(string[] args) {
// Create a file for output named TestFile.txt.
Stream myFile = File.Create("TestFile.txt");
/* Create a new text writer using the output stream, and add it to
* the trace listeners. */
TextWriterTraceListener myTextListener = new
TextWriterTraceListener(myFile);
Trace.Listeners.Add(myTextListener);
// Write output to the file.
Trace.Write("Test output ");
// Flush the output.
Trace.Flush();
return 0;
}
}
Public Class Sample
Public Shared Sub Main()
' Create a file for output named TestFile.txt.
Dim myFile As Stream = File.Create("TestFile.txt")
' Create a new text writer using the output stream, and add it to
' the trace listeners.
Dim myTextListener As New TextWriterTraceListener(myFile)
Trace.Listeners.Add(myTextListener)
' Write output to the file.
Trace.Write("Test output ")
' Flush the output.
Trace.Flush()
System.Environment.ExitCode = 0
End Sub
End Class
설명
클래스는 TextWriterTraceListener 추적 또는 디버깅 출력을 수신하는 텍스트 기록기를 얻거나 설정하는 속성을 제공합니다 Writer .
중요
이 형식이 구현 하는 IDisposable 인터페이스입니다. 형식을 사용 하 여 마쳤으면 직접 또는 간접적으로의 삭제 해야 있습니다. 직접 형식의 dispose 호출 해당 Dispose 의 메서드를 try/catch 블록입니다. 삭제 하지 직접, 언어 구문 같은 사용 using (C#에서) 또는 Using (Visual Basic에서는). 자세한 내용은 "를 사용 하는 개체는 구현 IDisposable" 섹션을 참조 하세요.를 IDisposable 인터페이스 항목입니다.
이 클래스는 더 이상 추적 또는 디버깅 출력, 의 출력 버퍼 및 Flush 에 대한 WriterWrite 메시지를 Writer수신하지 않도록 에 메서드 CloseWriter 를 제공합니다.
추적 수신기를 사용하려면 추적 또는 디버깅을 사용하도록 설정해야 합니다. 다음 구문은 특정 컴파일러입니다. C# 또는 Visual Basic 이외의 컴파일러를 사용 하면 컴파일러에 대 한 설명서를 참조 합니다.
C# 디버깅을 사용 하려면 다음을 추가 합니다
/d:DEBUG플래그를 추가할 수 있습니다 하거나 코드를 컴파일할 때 컴파일러 명령줄#define DEBUG파일의 맨 위로 이동 합니다. Visual Basic에서 추가 된/d:DEBUG=True컴파일러 명령줄 플래그입니다.C#에서 추적을 사용 하려면 추가 합니다
/d:TRACE코드를 컴파일할 때 컴파일러 명령줄 플래그#define TRACE파일의 맨 위로 이동 합니다. Visual Basic에서 추가 된/d:TRACE=True컴파일러 명령줄 플래그입니다.
.NET Framework 앱에 추적 수신기를 추가하려면 애플리케이션 이름에 해당하는 구성 파일을 편집합니다. 이 파일에 수신기를 추가, 해당 형식을 설정 하 고 해당 매개 변수를 설정, 수신기를 제거 하거나 지울 수 애플리케이션에서 이전에 설정한 모든 수신기입니다. 다음 예제와 같이 구성 파일의 형식은 같아야 합니다.
<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>
참고
사용 중이거나 사용할 수 없는 파일에 쓰려고 하면 파일 이름에 GUID가 자동으로 접두사로 추가됩니다.
생성자
| TextWriterTraceListener() |
TextWriterTraceListener 를 출력 수신자로 지정하여 TextWriter 클래스의 인스턴스를 초기화합니다. |
| TextWriterTraceListener(Stream) |
스트림을 디버깅 및 추적 출력의 수신자로 사용하여 TextWriterTraceListener 클래스의 새 인스턴스를 초기화합니다. |
| TextWriterTraceListener(Stream, String) |
스트림을 디버깅 및 추적 출력의 수신자로 사용하여, 지정된 이름의 TextWriterTraceListener 클래스의 새 인스턴스를 초기화합니다. |
| TextWriterTraceListener(String) |
파일을 디버깅 및 추적 출력의 수신자로 사용하여 TextWriterTraceListener 클래스의 새 인스턴스를 초기화합니다. |
| TextWriterTraceListener(String, String) |
파일을 디버깅 및 추적 출력의 수신자로 사용하여, 지정된 이름의 TextWriterTraceListener 클래스의 새 인스턴스를 초기화합니다. |
| TextWriterTraceListener(TextWriter) |
지정된 텍스트 작성기를 추적 또는 디버깅 출력의 수신자로 사용하여 TextWriterTraceListener 클래스의 새 인스턴스를 초기화합니다. |
| TextWriterTraceListener(TextWriter, String) |
지정된 텍스트 작성기를 추적 및 디버깅 출력의 수신자로 사용하여, 지정된 이름의 TextWriterTraceListener 클래스의 새 인스턴스를 초기화합니다. |
속성
| Attributes |
애플리케이션 구성 파일에 정의된 사용자 지정 추적 수신기 특성을 가져옵니다. (다음에서 상속됨 TraceListener) |
| Filter |
추적 수신기의 추적 필터를 가져오거나 설정합니다. (다음에서 상속됨 TraceListener) |
| IndentLevel |
들여쓰기 수준을 가져오거나 설정합니다. (다음에서 상속됨 TraceListener) |
| IndentSize |
들여쓰기의 공백 수를 가져오거나 설정합니다. (다음에서 상속됨 TraceListener) |
| IsThreadSafe |
추적 수신기가 스레드로부터 안전한지 여부를 나타내는 값을 가져옵니다. (다음에서 상속됨 TraceListener) |
| Name |
이 TraceListener의 이름을 가져오거나 설정합니다. (다음에서 상속됨 TraceListener) |
| NeedIndent |
출력의 들여쓰기 여부를 나타내는 값을 가져오거나 설정합니다. (다음에서 상속됨 TraceListener) |
| TraceOutputOptions |
추적 출력 옵션을 가져오거나 설정합니다. (다음에서 상속됨 TraceListener) |
| Writer |
추적 또는 디버깅 출력을 받는 텍스트 작성기를 가져오거나 설정합니다. |
메서드
| Close() |
추적 또는 디버깅 출력을 더 이상 받지 않도록 Writer를 닫습니다. |
| Close() |
파생 클래스에서 재정의할 때 더 이상 추적 또는 디버깅 출력을 받지 않도록 출력 스트림을 닫습니다. (다음에서 상속됨 TraceListener) |
| CreateObjRef(Type) |
원격 개체와 통신하는 데 사용되는 프록시 생성에 필요한 모든 관련 정보가 들어 있는 개체를 만듭니다. (다음에서 상속됨 MarshalByRefObject) |
| Dispose() |
TraceListener에서 사용하는 모든 리소스를 해제합니다. (다음에서 상속됨 TraceListener) |
| Dispose(Boolean) |
이 TextWriterTraceListener 개체를 삭제합니다. |
| Equals(Object) |
지정된 개체가 현재 개체와 같은지 확인합니다. (다음에서 상속됨 Object) |
| Fail(String) |
TraceListener 클래스를 구현할 때 생성한 수신기에 오류 메시지를 내보냅니다. (다음에서 상속됨 TraceListener) |
| Fail(String, String) |
TraceListener 클래스를 구현할 때 만든 수신기에 오류 메시지 및 자세한 오류 메시지를 내보냅니다. (다음에서 상속됨 TraceListener) |
| Flush() |
Writer의 출력 버퍼를 플러시합니다. |
| 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) |
추적 정보, 데이터 개체 및 이벤트 정보를 수신기별 출력에 씁니다. (다음에서 상속됨 TraceListener) |
| TraceData(TraceEventCache, String, TraceEventType, Int32, Object[]) |
추적 정보, 데이터 개체 배열 및 이벤트 정보를 수신기별 출력에 씁니다. (다음에서 상속됨 TraceListener) |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32) |
추적 및 이벤트 정보를 수신기별 출력에 씁니다. (다음에서 상속됨 TraceListener) |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32, String) |
추적 정보, 메시지 및 이벤트 정보를 수신기별 출력에 씁니다. (다음에서 상속됨 TraceListener) |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]) |
추적 정보, 서식 지정된 개체 배열 및 이벤트 정보를 수신기별 출력에 씁니다. (다음에서 상속됨 TraceListener) |
| TraceTransfer(TraceEventCache, String, Int32, String, Guid) |
추적 정보, 메시지, 관련 작업 ID 및 이벤트 정보를 수신기별 출력에 씁니다. (다음에서 상속됨 TraceListener) |
| Write(Object) |
ToString() 클래스를 구현할 때 생성한 수신기에 개체의 TraceListener 메서드 값을 씁니다. (다음에서 상속됨 TraceListener) |
| Write(Object, String) |
ToString() 클래스를 구현할 때 생성한 수신기에 범주 이름 및 개체의 TraceListener 메서드 값을 씁니다. (다음에서 상속됨 TraceListener) |
| Write(String) |
이 인스턴스의 Writer에 메시지를 씁니다. |
| Write(String, String) |
TraceListener 클래스를 구현할 때 생성한 수신기에 범주 이름 및 메시지를 씁니다. (다음에서 상속됨 TraceListener) |
| WriteIndent() |
이 클래스를 구현할 때 생성한 수신기에 들여쓰기를 하고 NeedIndent 속성을 |
| WriteLine(Object) |
ToString() 클래스를 구현할 때 생성한 수신기에 개체의 TraceListener 메서드 값을 쓴 다음 줄 종결자를 씁니다. (다음에서 상속됨 TraceListener) |
| WriteLine(Object, String) |
ToString() 클래스를 구현할 때 생성한 수신기에 범주 이름 및 개체의 TraceListener 메서드 값을 쓴 다음 줄 종결자를 씁니다. (다음에서 상속됨 TraceListener) |
| WriteLine(String) |
줄 종결자가 뒤에 오는 이 인스턴스의 Writer에 메시지를 씁니다. 기본 줄 종결자는 캐리지 리턴과 줄 바꿈(\r\n) 조합입니다. |
| WriteLine(String, String) |
TraceListener 클래스를 구현할 때 생성한 수신기에 범주 이름 및 메시지를 쓴 다음 줄 종결자를 씁니다. (다음에서 상속됨 TraceListener) |
적용 대상
추가 정보
.NET