<sharedListeners>의 <add>에 대한 <filter> 요소

2011-08-09

sharedListeners 컬렉션의 수신기에 필터를 추가합니다.

<filter type="System.Diagnostics.EventTypeFilter" 
  initializeData="Warning" />

특성 및 요소

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

특성

특성	설명
type	필수 특성입니다. 필터의 형식을 지정합니다. Type.FullName 속성의 형식으로 된 형식의 전체 이름만 사용하거나 Type.AssemblyQualifiedName 속성의 형식으로 된 어셈블리 정보가 포함된 정규화된 형식 이름을 사용할 수 있습니다. 정규화된 형식 이름을 만드는 데 대한 자세한 내용은 정규화된 형식 이름 지정을 참조하십시오.
initializeData	선택적 특성입니다. 지정한 클래스에 대해 생성자에 전달되는 문자열입니다.

type

필수 특성입니다.

필터의 형식을 지정합니다. Type.FullName 속성의 형식으로 된 형식의 전체 이름만 사용하거나 Type.AssemblyQualifiedName 속성의 형식으로 된 어셈블리 정보가 포함된 정규화된 형식 이름을 사용할 수 있습니다. 정규화된 형식 이름을 만드는 데 대한 자세한 내용은 정규화된 형식 이름 지정을 참조하십시오.

initializeData

선택적 특성입니다.

지정한 클래스에 대해 생성자에 전달되는 문자열입니다.

자식 요소

없음

부모 요소

요소	설명
configuration	공용 언어 런타임 및 .NET Framework 응용 프로그램에서 사용하는 모든 구성 파일의 루트 요소입니다.
system.diagnostics	메시지를 수집하여 저장하고 라우팅하는 추적 수신기와 추적 스위치를 설정할 수준을 지정합니다.
sharedListeners	임의의 소스 또는 추적 요소가 참조할 수 있는 수신기의 컬렉션입니다.
add	sharedListeners 컬렉션에 수신기를 추가합니다.

설명

<sharedListeners> 요소의 <add> 요소에서 수신기가 정의된 경우 해당 수신기의 필터는 <add> 요소의 자식인 <filter> 요소에서 정의되어야 합니다.

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

예제

다음 예제에서는 <filter> 요소를 사용하여 sharedListeners 컬렉션의 추적 수신기 console에 필터를 추가하는 방법을 보여 줍니다.

<configuration>
  <system.diagnostics>
    <sources>
      <source name="myTraceSource" >
        <listeners>
          <add name="console" />
          <remove name="Default" />
        </listeners>
      </source>
    </sources>
    <sharedListeners>
      <add name="console" 
        type="System.Diagnostics.ConsoleTraceListener" >
        <filter type="System.Diagnostics.EventTypeFilter" 
          initializeData="Error" />
      </add>
    </sharedListeners>
  </system.diagnostics>
</configuration>