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

아티클
08/20/2008

업데이트: 2007년 11월

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

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

<clear/>

특성 및 요소

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

특성

없음

자식 요소

없음

부모 요소

요소	설명
configuration	공용 언어 런타임 및 .NET Framework 응용 프로그램에서 사용하는 모든 구성 파일의 루트 요소입니다.
system.diagnostics	메시지를 수집하여 저장하고 라우팅하는 추적 수신기와 추적 스위치를 설정할 수준을 지정합니다.
sources	추적 메시지를 발생시키는 추적 소스를 포함합니다.
source	추적 메시지를 발생시키는 추적 소스를 지정합니다.
listeners	메시지를 수집하여 저장하고 라우팅하는 수신기를 지정합니다.

설명

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

구성 파일

이 요소는 컴퓨터 구성 파일(Machine.config) 및 응용 프로그램 구성 파일에 사용할 수 있습니다.

예제

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

<configuration>
  <system.diagnostics>
    <sources>
       <source name="TraceSourceApp" switchName="sourceSwitch" 
         switchType="System.Diagnostics.SourceSwitch">
        <listeners>
          <clear/>
          <add name="console" 
            type="System.Diagnostics.ConsoleTraceListener"/>
          <add name="textListener"/>
        </listeners>
      </source>
    </sources>
    <sharedListeners>
      <add name="textListener" 
        type="System.Diagnostics.TextWriterTraceListener" 
        initializeData="myListener.log"/>
    </sharedListeners>
    <switches>
      <add name="sourceSwitch" value="Warning"/>
    </switches>
  </system.diagnostics>
</configuration>