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

아티클
08/20/2008

업데이트: 2007년 11월

추적에 대한 Listeners 컬렉션을 지웁니다.

<configuration> 요소
  <system.diagnostics> 요소
    <trace> 요소
      <trace>의 <listeners> 요소
        <trace>의 <listeners>에 대한 <clear> 요소

<clear/>

특성 및 요소

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

특성

없음

자식 요소

없음

부모 요소

요소	설명
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가 없는 경우에는 메시지 상자가 표시되지 않습니다.

예제

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

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