<추적> 요소

아티클
04/08/2023

추적 메시지를 수집하고 저장하고 라우팅하는 수신기가 포함되어 있습니다.

<configuration>
<system.diagnostics>
<trace>

구문

<trace autoflush="true|false"
       indentsize="indent value"  
       useGlobalLock="true| false"/>

특성 및 요소

다음 섹션에서는 특성, 자식 요소 및 부모 요소에 대해 설명합니다.

특성

특성	설명
`autoflush`	선택적 특성입니다. 모든 쓰기 작업 후에 추적 수신기가 출력 버퍼를 자동으로 플러시하는지 여부를 지정합니다.
`indentsize`	선택적 특성입니다. 들여쓰기할 공백 수를 지정합니다.
`useGlobalLock`	선택적 특성입니다. 전역 잠금을 사용해야 하는지 여부를 나타냅니다.

autoflush 특성

값	Description
`false`	출력 버퍼를 자동으로 플러시하지 않습니다. 기본값입니다.
`true`	출력 버퍼를 자동으로 플러시합니다.

useGlobalLock 특성

값	Description
`false`	수신기가 스레드로부터 안전한 경우 전역 잠금을 사용하지 않고, 안전하지 않으면 전역 잠금을 사용합니다.
`true`	수신기가 스레드로부터 안전한지 여부에 관계없이 전역 잠금을 사용합니다. 기본값입니다.

자식 요소

요소	Description
<listeners>	메시지를 수집, 저장 및 라우팅하는 수신기를 지정합니다.

부모 요소

요소	Description
`configuration`	공용 언어 런타임 및 .NET Framework 애플리케이션에서 사용하는 모든 구성 파일의 루트 요소입니다.
`system.diagnostics`	메시지를 수집하고 저장하고 라우팅하는 추적 수신기를 지정하며, 추적 스위치가 설정되는 수준을 지정합니다.

예제

다음 예제에서는 Listeners 컬렉션에 수신기 MyListener를 추가하기 위해 <trace> 요소를 사용하는 방법을 보여 줍니다. MyListener는 MyListener.log라는 파일을 만들고 파일에 출력을 씁니다. useGlobalLock 특성은 false로 설정되므로 추적 수신기가 스레드로부터 안전한 경우 전역 잠금이 사용되지 않습니다. autoflush 특성은 true로 설정됩니다. 이 경우 Trace.Flush 메서드가 호출되는지 여부에 관계없이 추적 수신기가 파일에 씁니다. indentsize 특성은 0으로 설정되므로 Trace.Indent 메서드가 호출될 때 수신기가 0개의 공백을 들여씁니다.

<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>