<trace>에 대한 <listeners>의 <clear> 요소

  • 아티클

추적의 Listeners 컬렉션을 지웁니다.

<configuration>
  <system.diagnostics>
    <trace>
      <listeners>
        <clear>

구문

<clear/>

특성 및 요소

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

특성

없음

자식 요소

없음

부모 요소

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

설명

<clear> 요소는 추적을 위해 Listeners 컬렉션에서 모든 수신기를 제거합니다. <add> 요소를 사용하기 전에 <clear> 요소를 사용하여 컬렉션에 다른 활성 수신기가 없는지 확인할 수 있습니다.

Trace.Listeners속성(System.Diagnostics.Trace.Listeners.Clear())에서 Clear 메서드를 호출하여 프로그래밍 방식으로 Listeners 컬렉션을 지울 수 있습니다.

이 요소는 컴퓨터 구성 파일(Machine.config) 및 애플리케이션 구성 파일에서 사용할 수 있습니다.

참고

<clear> 요소는 Listeners 컬렉션에서 DefaultTraceListener를 제거하여 Debug.Assert, Trace.Assert, Debug.Fail, Trace.Fail 메서드의 동작을 변경합니다. 일반적으로 Assert 또는 Fail 메서드를 호출하면 메시지 상자가 표시됩니다. 그러나 Listeners 컬렉션에 없는 경우 DefaultTraceListener 메시지 상자가 표시되지 않습니다.

예제

다음 예제에서는 추적을 위해 Listeners 컬렉션에 수신기 console을 추가하기 위해 <add> 요소를 사용하기 전 <clear> 요소를 사용하는 방법을 보여 줍니다.

<configuration>  
  <system.diagnostics>  
    <trace autoflush="false" indentsize="4">  
      <listeners>  
        <clear/>  
        <add name="console"
          type="System.Diagnostics.ConsoleTraceListener" >  
          <filter type="System.Diagnostics.EventTypeFilter"
            initializeData="Error" />  
        </add>  
      </listeners>  
    </trace>  
  </system.diagnostics>  
</configuration>

참고 항목