<source>의 <listeners>에 대한 <add> 요소
업데이트: 2007년 11월
추적 소스에 대한 Listeners 컬렉션에 수신기를 추가합니다.
<configuration> 요소
<system.diagnostics> 요소
<sources> 요소
<source> 요소
<trace>의 <listeners> 요소
<source>의 <listeners>에 대한 <add> 요소
<add name="name"
type="TraceListenerClassName, Version, Culture, PublicKeyToken"
initializeData="data"/>
특성 및 요소
다음 단원에서는 특성, 자식 요소 및 부모 요소에 대해 설명합니다.
특성
특성 |
설명 |
|---|---|
type |
필수 특성입니다. 수신기 형식을 지정합니다. 정규화된 형식 이름 지정에 지정된 요구 사항을 충족하는 문자열을 사용해야 합니다. |
initializeData |
선택적 특성입니다. 지정한 클래스에 대해 생성자에 전달되는 문자열입니다. 클래스에 문자열을 사용하는 생성자가 없으면 ConfigurationException이 throw됩니다. |
name |
선택적 특성입니다. 수신기 이름을 지정합니다. |
traceOutputOptions |
선택적 특성입니다. 추적 수신기에 대한 TraceOutputOptions 속성 값을 지정합니다. |
[사용자 지정 특성] |
선택적 특성입니다. 해당 수신기에 대한 GetSupportedAttributes 메서드에 의해 식별되는 수신기 고유의 특성 값을 지정합니다. Delimiter는 DelimitedListTraceListener 클래스에 고유한 추가 특성의 한 예입니다. |
자식 요소
요소 |
설명 |
|---|---|
추적 소스에 대한 Listeners 컬렉션의 수신기에 필터를 추가합니다. |
부모 요소
요소 |
설명 |
|---|---|
configuration |
공용 언어 런타임 및 .NET Framework 응용 프로그램에서 사용하는 모든 구성 파일의 루트 요소입니다. |
system.diagnostics |
메시지를 수집하여 저장하고 라우팅하는 추적 수신기와 추적 스위치를 설정할 수준을 지정합니다. |
sources |
추적 메시지를 발생시키는 추적 소스를 포함합니다. |
source |
추적 메시지를 발생시키는 추적 소스를 지정합니다. |
listeners |
메시지를 수집하여 저장하고 라우팅하는 수신기를 지정합니다. |
설명
.NET Framework와 함께 제공되는 수신기 클래스는 TraceListener 클래스에서 파생됩니다.
추적 수신기의 name 특성을 지정하지 않으면 추적 수신기의 Name 속성 기본값은 빈 문자열("")이 됩니다. 응용 프로그램에 하나의 수신기만 있는 경우 이름을 지정하지 않고 이 수신기를 추가할 수 있으며 이름에 빈 문자열을 지정하여 이 수신기를 제거할 수도 있습니다. 그러나 응용 프로그램에 둘 이상의 수신기가 있으면 TraceSource.Listeners 컬렉션에서 개별 추적 수신기를 식별하고 관리할 수 있도록 각 추적 수신기에 고유한 이름을 지정해야 합니다.
참고
동일한 이름을 가진 동일한 형식의 추적 수신기를 둘 이상 추가하면 해당 형식과 이름의 추적 수신기가 하나만 Listeners 컬렉션에 추가됩니다. 그러나 여러 개의 동일한 수신기를 Listeners 컬렉션에 프로그래밍 방식으로 추가할 수 있습니다.
initializeData 특성 값은 만들 수신기 형식에 따라 결정됩니다. 모든 추적 수신기에 initializeData를 지정할 필요는 없습니다.
참고
initializeData 특성을 사용하는 경우 컴파일러 경고 메시지 "'initializeData' 특성이 선언되지 않았습니다."가 나타납니다. 이 경고는 initializeData 특성을 인식하지 않는 추상 기본 클래스 TraceListener에 의해 구성 설정의 유효성이 검사된 경우 발생합니다. 일반적으로 매개 변수를 사용하는 생성자가 있는 추적 수신기 구현의 경우에는 이 경고를 무시해도 됩니다.
다음 표에서는 .NET Framework와 함께 제공되는 추적 수신기를 보여 주고 해당 initializeData 특성 값에 대해 설명합니다.
추적 수신기 클래스 |
initializeData 특성 값 |
|---|---|
ConsoleTraceListener 생성자의 useErrorStream 값입니다. 추적 및 디버그 출력을 표준 오류 스트림에 쓰려면 initializeData 특성을 "true"로 설정하고 표준 출력 스트림에 쓰려면 "false"로 설정합니다. |
|
DelimitedListTraceListener가 쓸 파일 이름입니다. |
|
기존 이벤트 로그 소스의 이름입니다. |
|
EventSchemaTraceListener가 쓸 파일 이름입니다. |
|
TextWriterTraceListener가 쓸 파일 이름입니다. |
|
XmlWriterTraceListener가 쓸 파일 이름입니다. |
구성 파일
이 요소는 컴퓨터 구성 파일(Machine.config) 및 응용 프로그램 구성 파일에 사용할 수 있습니다.
예제
다음 예제에서는 <add> 요소를 사용하여 console 및 textListener 수신기를 추적 소스 TraceSourceApp에 대한 Listeners 컬렉션에 추가하는 방법을 보여 줍니다. textListener 수신기는 추적 출력을 myListener.log 파일에 씁니다.
<configuration>
<system.diagnostics>
<sources>
<source name="TraceSourceApp" switchName="sourceSwitch"
switchType="System.Diagnostics.SourceSwitch">
<listeners>
<add name="console"
type="System.Diagnostics.ConsoleTraceListener"/>
<add name="textListener"/>
<remove name="Default"/>
</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>