연습: My.Application.Log가 정보를 기록하는 위치 변경(Visual Basic)

아티클
08/15/2011

My.Application.Log 및 My.Log 개체를 사용하여 응용 프로그램에서 발생하는 이벤트에 대한 정보를 기록할 수 있습니다. 이 연습에서는 기본 설정을 재정의하고 Log 개체가 다른 로그 수신기에 쓰도록 만드는 방법을 보여 줍니다.

사전 요구 사항

Log 개체는 여러 로그 수신기에 정보를 쓸 수 있습니다. 구성을 변경하기 전에 로그 수신기의 현재 구성을 확인해야 합니다. 자세한 내용은 연습: My.Application.Log가 정보를 기록하는 위치 확인(Visual Basic)을 참조하십시오.

방법: 텍스트 파일에 이벤트 정보 쓰기(Visual Basic) 또는 방법: 응용 프로그램 이벤트 로그에 쓰기(Visual Basic)를 참조할 수도 있습니다.

수신기를 추가하려면

솔루션 탐색기에서 app.config를 마우스 오른쪽 단추로 클릭하고 열기를 선택합니다.

-또는-

app.config 파일이 없을 경우
1. 프로젝트 메뉴에서 새 항목 추가를 선택합니다.
2. 새 항목 추가 대화 상자에서 응용 프로그램 구성 파일을 선택합니다.
3. 추가를 클릭합니다.
<sources> 섹션에서 name 특성이 "DefaultSource"인 <source> 섹션 아래에 있는 <listeners> 섹션을 찾습니다. <sources> 섹션은 최상위 <configuration> 섹션의 <system.diagnostics> 섹션에 있습니다.

다음 요소를 <listeners> 섹션에 추가합니다.

<!-- Uncomment to connect the application file log. -->
<!-- <add name="FileLog" /> -->
<!-- Uncomment to connect the event log. -->
<!-- <add name="EventLog" /> -->
<!-- Uncomment to connect the event log. -->
<!-- <add name="Delimited" /> -->
<!-- Uncomment to connect the XML log. -->
<!-- <add name="XmlWriter" /> -->
<!-- Uncomment to connect the console log. -->
<!-- <add name="Console" /> -->

Log 메시지를 받을 로그 수신기의 주석을 해제합니다.
최상위 <configuration> 섹션의 <system.diagnostics> 섹션에서 <sharedListeners> 섹션을 찾습니다.

다음 요소를 <sharedListeners> 섹션에 추가합니다.

      <add name="FileLog"
           type="Microsoft.VisualBasic.Logging.FileLogTraceListener, 
                 Microsoft.VisualBasic, Version=8.0.0.0, 
                 Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a"
           initializeData="FileLogWriter" />
      <add name="EventLog"
           type="System.Diagnostics.EventLogTraceListener, 
                 System, Version=2.0.0.0, 
                 Culture=neutral, PublicKeyToken=b77a5c561934e089"
           initializeData="sample application"/>
      <add name="Delimited" 
           type="System.Diagnostics.DelimitedListTraceListener, 
                 System, Version=2.0.0.0, 
                 Culture=neutral, PublicKeyToken=b77a5c561934e089"
           initializeData="c:\temp\sampleDelimitedFile.txt"
           traceOutputOptions="DateTime" />
      <add name="XmlWriter"
           type="System.Diagnostics.XmlWriterTraceListener, 
                 System, Version=2.0.0.0, 
                 Culture=neutral, PublicKeyToken=b77a5c561934e089"
           initializeData="c:\temp\sampleLogFile.xml" />
      <add name="Console"
           type="System.Diagnostics.ConsoleTraceListener, 
                 System, Version=2.0.0.0, 
                 Culture=neutral, PublicKeyToken=b77a5c561934e089"
           initializeData="true" />

app.config 파일의 내용은 다음 XML과 비슷합니다.

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
  <system.diagnostics>
    <sources>
      <!-- This section configures My.Application.Log -->
      <source name="DefaultSource" switchName="DefaultSwitch">
        <listeners>
          <add name="FileLog"/>
          <!-- Uncomment to connect the application file log. -->
          <!-- <add name="FileLog" /> -->
          <!-- Uncomment to connect the event log. -->
          <!-- <add name="EventLog" /> -->
          <!-- Uncomment to connect the event log. -->
          <!-- <add name="Delimited" /> -->
          <!-- Uncomment to connect the XML log. -->
          <!-- <add name="XmlWriter" /> -->
          <!-- Uncomment to connect the console log. -->
          <!-- <add name="Console" /> -->
        </listeners>
      </source>
    </sources>
    <switches>
      <add name="DefaultSwitch" value="Information" />
    </switches>
    <sharedListeners>
      <add name="FileLog"
           type="Microsoft.VisualBasic.Logging.FileLogTraceListener, 
                 Microsoft.VisualBasic, Version=8.0.0.0, 
                 Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a"
           initializeData="FileLogWriter" />
      <add name="EventLog"
           type="System.Diagnostics.EventLogTraceListener, 
                 System, Version=2.0.0.0, 
                 Culture=neutral, PublicKeyToken=b77a5c561934e089"
           initializeData="sample application"/>
      <add name="Delimited" 
           type="System.Diagnostics.DelimitedListTraceListener, 
                 System, Version=2.0.0.0, 
                 Culture=neutral, PublicKeyToken=b77a5c561934e089"
           initializeData="c:\temp\sampleDelimitedFile.txt"
           traceOutputOptions="DateTime" />
      <add name="XmlWriter"
           type="System.Diagnostics.XmlWriterTraceListener, 
                 System, Version=2.0.0.0, 
                 Culture=neutral, PublicKeyToken=b77a5c561934e089"
           initializeData="c:\temp\sampleLogFile.xml" />
      <add name="Console"
           type="System.Diagnostics.ConsoleTraceListener, 
                 System, Version=2.0.0.0, 
                 Culture=neutral, PublicKeyToken=b77a5c561934e089"
           initializeData="true" />
    </sharedListeners>
  </system.diagnostics>
</configuration>

수신기를 다시 구성하려면

<sharedListeners> 섹션에서 수신기의 <add> 요소를 찾습니다.
type 특성이 수신기 형식의 이름을 제공합니다. 이 형식은 TraceListener 클래스에서 상속해야 합니다. 올바른 형식이 사용되도록 강력한 이름의 형식 이름을 사용하십시오. 자세한 내용은 아래의 "강력한 이름의 형식을 참조하려면"을 참조하십시오.

다음 형식을 사용할 수 있습니다.
- 파일 로그에 쓰는 Microsoft.VisualBasic.Logging.FileLogTraceListener 수신기
- initializeData 매개 변수로 지정된 컴퓨터 이벤트 로그에 정보를 쓰는 System.Diagnostics.EventLogTraceListener 수신기
- initializeData 매개 변수에 지정된 파일에 쓰는 System.Diagnostics.DelimitedListTraceListener 및 System.Diagnostics.XmlWriterTraceListener 수신기
- 명령줄 콘솔에 쓰는 System.Diagnostics.ConsoleTraceListener 수신기
다른 형식의 로그 수신기가 정보를 쓰는 위치에 대한 자세한 내용은 해당 형식의 설명서를 참조하십시오.
응용 프로그램에서는 로그 수신기 개체를 만들 때 initializeData 특성을 생성자 매개 변수로 전달합니다. initializeData 특성의 의미는 추적 수신기에 따라 달라집니다.
로그 수신기를 만든 후 응용 프로그램에서는 수신기의 속성을 설정합니다. 이들 속성은 <add> 요소의 다른 특성에 의해 정의됩니다. 특정 수신기의 속성에 대한 자세한 내용은 해당 수신기 형식의 설명서를 참조하십시오.

강력한 이름의 형식을 참조하려면

로그 수신기에 올바른 형식이 사용되도록 하려면 정규화된 형식 이름과 강력한 이름의 어셈블리 이름을 사용하십시오. 강력한 이름의 형식은 다음과 같은 구문을 갖습니다.

<type name>, <assembly name>, <version number>, <culture>, <strong name>
이 코드 예제에서는 정규화된 형식(이 경우 "System.Diagnostics.FileLogTraceListener")에 대한 강력한 이름이 지정된 형식 이름을 확인하는 방법을 보여 줍니다.
```
Public Sub DisplayStrongName()
    Dim t As Type = GetType(Logging.FileLogTraceListener)
    MsgBox(t.FullName & ", " & t.Assembly.FullName)
End Sub
```
출력은 다음과 같으며, 위의 "수신기를 추가하려면" 절차에서처럼 이 출력을 사용하여 강력한 이름의 형식을 고유하게 참조할 수 있습니다.

Microsoft.VisualBasic.Logging.FileLogTraceListener, Microsoft.VisualBasic, Version=8.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a