<trace> 요소
업데이트: 2007년 11월
추적 메시지를 수집하여 저장하고 라우팅하는 수신기가 들어 있습니다.
<configuration> 요소
<system.diagnostics> 요소
<trace> 요소
<trace autoflush="true|false"
indentsize="indent value"
useGlobalLock="true| false"/>
특성 및 요소
다음 단원에서는 특성, 자식 요소 및 부모 요소에 대해 설명합니다.
특성
특성 |
설명 |
|---|---|
autoflush |
선택적 특성입니다. 매 쓰기 작업 후 추적 수신기가 출력 버퍼를 자동으로 플러시할지 지정합니다. |
indentsize |
선택적 특성입니다. 들여쓸 공백의 수를 지정합니다. |
useGlobalLock |
선택적 특성입니다. 전역 잠금 사용 여부를 나타냅니다. |
autoflush 특성
값 |
설명 |
|---|---|
false |
출력 버퍼를 자동으로 플러시하지 않습니다. 이 값이 기본값입니다. |
true |
출력 버퍼를 자동으로 플러시합니다. |
useGlobalLock 특성
값 |
설명 |
|---|---|
false |
수신기가 스레드로부터 안전하면 전역 잠금을 사용하지 않고, 그렇지 않으면 전역 잠금을 사용합니다. |
true |
수신기가 스레드로부터 안전한지 여부와 상관없이 전역 잠금을 사용합니다. 이 값이 기본값입니다. |
자식 요소
요소 |
설명 |
|---|---|
메시지를 수집하여 저장하고 라우팅하는 수신기를 지정합니다. |
부모 요소
요소 |
설명 |
|---|---|
configuration |
공용 언어 런타임 및 .NET Framework 응용 프로그램에서 사용하는 모든 구성 파일의 루트 요소입니다. |
system.diagnostics |
메시지를 수집하여 저장하고 라우팅하는 추적 수신기와 추적 스위치를 설정할 수준을 지정합니다. |
예제
다음 예제에서는 <trace> 요소를 사용하여 Listeners 컬렉션에 MyListener 수신기를 추가하는 방법을 보여 줍니다. MyListener는 MyListener.log라는 파일을 만들어 그 파일에 출력을 씁니다. useGlobalLock 특성을 false로 설정하면 추적 수신기가 스레드로부터 안전한 경우 전역 잠금이 사용되지 않습니다. autoflush 특성을 true로 설정하면 Trace.Flush 메서드 호출 여부와 관계없이 추적 수신기가 파일에 쓸 수 있습니다. indentsize 특성을 0으로 설정하면 Trace.Indent 메서드가 호출될 때 수신기가 들여쓰기하지 않습니다.
<configuration>
<system.diagnostics>
<trace useGlobalLock="false" autoflush="true" indentsize="0">
<listeners>
<add name="myListener" type="System.Diagnostics.TextWriterTraceListener, system version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" initializeData="c:\myListener.log" />
</listeners>
</trace>
</system.diagnostics>
</configuration>