FileLogTraceListener 클래스

참조

정의

네임스페이스:: Microsoft.VisualBasic.Logging

어셈블리:: Microsoft.VisualBasic.dll

어셈블리:: Microsoft.VisualBasic.Forms.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

로깅 출력을 파일로 보내는 간단한 수신기를 제공합니다.

public ref class FileLogTraceListener : System::Diagnostics::TraceListener

[System.Runtime.InteropServices.ComVisible(false)]
public class FileLogTraceListener : System.Diagnostics.TraceListener

[<System.Runtime.InteropServices.ComVisible(false)>]
type FileLogTraceListener = class
    inherit TraceListener

Public Class FileLogTraceListener
Inherits TraceListener

상속: Object

MarshalByRefObject

TraceListener
FileLogTraceListener

특성: ComVisibleAttribute

설명

클래스는 FileLogTraceListener 매일 또는 애플리케이션별로 필요에 따라 로그 파일을 보관하는 자동화된 유지 관리 기능을 제공합니다. 이 자동 보관 기능은 개발자와 관리자의 유지 관리 책임을 줄이는 데 도움이 됩니다.

의 FileLogTraceListener instance 또는 Trace.Listeners 컬렉션에 Debug.Listeners 추가하여 로깅에서 텍스트 파일로 출력을 리디렉션할 수 있습니다. 이 클래스의 인스턴스를 추가할 수도 있습니다 My.Application.Log 또는 My.Log (웹 애플리케이션)에 대 한 Visual Basic 애플리케이션에서 합니다. 자세한 내용은 연습: My.Application.Log가 정보를 기록하는 위치 변경을 참조하십시오.

이 클래스의 기본 기능은 다음과 같습니다.

보관 기능. 이 클래스에서 생성된 로그 파일의 이름은 로그 파일과 로그의 연속 버전을 구분하는 숫자와 함께 기본 이름 및 날짜에 따라 지정됩니다. 새 로그 파일은 필요에 따라 만들어집니다.

파일 이름의 명시적 형식은 baseName[-dateStamp][-version].log, 여기서는 다음과 같습니다.
- 파트는 baseName 속성에 의해 지정된 기본 로그 이름입니다 BaseFileName .
- 파트의 형식은 dateStamp "YYYY-MM-DD"이며 가 또는 Weekly일 때 LogFileCreationSchedule Daily 표시됩니다.
- 동일한 baseName 및 dateStampversion 를 사용하여 둘 이상의 로그 파일이 필요한 경우 양수Integer인 파트가 파일 이름에 추가됩니다.
여러 클래스 인스턴스. 클래스의 FileLogTraceListener instance 사용 중인 파일에 쓰는 경우:
- 클래스는 동일한 프로세스에서 클래스의 FileLogTraceListener 다른 instance 사용하는 경우 파일을 공유합니다.
- 클래스는 다른 프로세스에서 파일을 사용하는 경우 사용 가능한 다음 이름을 사용하여 새 로그 파일을 만듭니다.
스레드 안전성. 클래스는 FileLogTraceListener 스레드로부터 안전합니다. 이렇게 하면 잠금을 사용하지 않고도 여러 스레드에서 로그에 메시지를 안전하게 쓸 수 있습니다.

로그 파일 위치

속성은 Location 열거형을 LogFileLocation 사용하여 로그 파일을 쓸 일반적인 디렉터리 중 하나를 지정합니다.
다른 위치에 로그를 쓰려면 속성을 해당 위치로 설정합니다 CustomLocation .

로그 파일 이름

로그 파일의 기본 이름은 속성으로 BaseFileName 지정됩니다.
현재 로그 파일 이름은 속성에서 FullLogFileName 읽을 수 있습니다. 파일 시스템의 여러 다른 속성 및 로그의 현재 상태에서 파생됩니다.

로그 유지 관리

새 로그 파일을 만들기 위한 최소 빈도는 속성에 LogFileCreationSchedule 의해 결정됩니다. 값이 또는 Weekly이 Daily 면 새 로그 파일이 매일 또는 일주일에 한 번 이상 만들어지고 날짜 스탬프가 이름에 FullLogFileName 통합됩니다.
로그 파일의 최대 크기(바이트)는 속성에 MaxFileSize 의해 결정됩니다. 로그 파일 크기가 이 크기를 초과하면 로그에 기록된 추가 메시지가 삭제되고 속성에 DiskSpaceExhaustedBehavior 따라 예외가 throw됩니다.
속성은 ReserveDiskSpace 사용 가능한 공간(바이트)을 결정합니다. 이렇게 하면 클래스가 FileLogTraceListener 사용 가능한 모든 디스크 공간을 사용하지 않도록 할 수 있습니다. 사용 하는 DiskSpaceExhaustedBehavior 경우 로그 쓰기의 동작을 지정 하는 속성보다 ReserveDiskSpace 적은 바이트 무료입니다.

로그 파일 출력 설정

속성은 AutoFlush 로그 파일에 쓸 때마다 기본 스트림을 자동으로 플러시할지 여부를 지정합니다.
속성은 Append 메시지를 현재 로그 파일에 추가할지(허용되는 경우) 또는 새 로그 파일에 쓸지 여부를 지정합니다.
속성은 Delimiter 로그 메시지 내의 필드를 구분하는 데 사용할 문자열을 지정합니다.
속성은 Encoding 새 로그 파일을 만들 때 사용할 인코딩을 지정합니다.

로그 파일 출력

및 TraceEvent 메서드는 TraceData 로그 파일에 메시지를 씁니다. 이러한 메서드는 새 로그를 LogFileCreationSchedule 만들어야 하는지 여부를 확인하기 위해 동일한 기본 이름을 가진 기존 로그와 함께 속성을 검사.
메서드는 Flush 현재 출력 버퍼에 있는 모든 메시지를 로그 파일로 플러시합니다.
메서드는 Close 다른 프로세스에서 사용할 수 있도록 로그 파일을 닫습니다.

출력 사용

추적 수신기를 사용하려면 추적 또는 디버깅을 사용하도록 설정해야 합니다. 다음 구문은 특정 컴파일러입니다. C# 또는 Visual Basic 이외의 컴파일러를 사용 하면 컴파일러에 대 한 설명서를 참조 합니다.

C# 디버깅을 사용 하려면 다음을 추가 합니다 /d:DEBUG 플래그를 추가할 수 있습니다 하거나 코드를 컴파일할 때 컴파일러 명령줄 #define DEBUG 파일의 맨 위로 이동 합니다. Visual Basic에서 추가 된 /d:DEBUG=True 컴파일러 명령줄 플래그입니다.
C#에서 추적을 사용 하려면 추가 합니다 /d:TRACE 코드를 컴파일할 때 컴파일러 명령줄 플래그 #define TRACE 파일의 맨 위로 이동 합니다. Visual Basic에서 추가 된 /d:TRACE=True 컴파일러 명령줄 플래그입니다.

.NET Framework 앱에서는 애플리케이션의 구성 파일을 편집하여 수신기 수준을 설정할 수 있습니다. 이 파일에 수신기를 추가, 해당 형식을 설정 하 고 해당 매개 변수를 설정, 수신기를 제거 하거나 지울 수 애플리케이션에서 이전에 설정한 모든 수신기입니다. 다음 예제와 같이 구성 파일의 형식은 같아야 합니다.

<configuration>  
    <system.diagnostics>  
        <sharedListeners>  
            <add name="FileLog"  
                type="Microsoft.VisualBasic.Logging.FileLogTraceListener,   
                      Microsoft.VisualBasic, Version=8.0.0.0,   
                      Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a,   
                      processorArchitecture=MSIL"   
                initializeData="FileLogWriter"/>  
        </sharedListeners>  
    </system.diagnostics>  
</configuration>

이 예제를 실행하려면 정규화된 어셈블리 이름을 제공해야 합니다. 참조 된 정규화 된 어셈블리 이름을 가져오는 방법에 대 한 내용은 어셈블리 이름합니다.

생성자

FileLogTraceListener()	기본 이름을 사용하여 FileLogTraceListener 클래스의 새 인스턴스를 초기화합니다.
FileLogTraceListener(String)	제공된 이름을 사용하여 FileLogTraceListener 클래스의 새 인스턴스를 초기화합니다.

속성

Append	현재 파일에 출력을 추가할지 또는 새 파일이나 기존 파일에 출력을 쓸지 여부를 결정합니다.
Attributes	애플리케이션 구성 파일에 정의된 사용자 지정 추적 수신기 특성을 가져옵니다. (다음에서 상속됨 TraceListener)
AutoFlush	로그 파일 스트림에 쓰고 버퍼를 플러시하는지 여부를 나타냅니다.
BaseFileName	로그 파일의 기본 이름을 가져오거나 설정합니다. 이 이름은 전체 로그 파일 이름을 만드는 데 사용됩니다.
CustomLocation	Location 속성이 Custom으로 설정될 때 로그 파일 디렉터리를 가져오거나 설정합니다.
Delimiter	로그 메시지에서 필드를 구분하는 데 사용되는 구분 기호를 가져오거나 설정합니다.
DiskSpaceExhaustedBehavior	로그 파일에 쓸 때 ReserveDiskSpace 속성에서 지정한 사용 가능한 공간보다 공간이 더 적은 경우 취할 동작을 결정합니다.
Encoding	새 로그 파일을 만들 때 사용할 인코딩을 가져오거나 설정합니다.
Filter	추적 수신기의 추적 필터를 가져오거나 설정합니다. (다음에서 상속됨 TraceListener)
FullLogFileName	현재 전체 로그 파일 이름을 가져옵니다.
IncludeHostName	로깅 시스템의 호스트 이름이 출력에 포함되어야 하는지 여부를 나타냅니다.
IndentLevel	들여쓰기 수준을 가져오거나 설정합니다. (다음에서 상속됨 TraceListener)
IndentSize	들여쓰기의 공백 수를 가져오거나 설정합니다. (다음에서 상속됨 TraceListener)
IsThreadSafe	추적 수신기가 스레드로부터 안전한지 여부를 나타내는 값을 가져옵니다. (다음에서 상속됨 TraceListener)
Location	로그 파일의 위치를 가져오거나 설정합니다.
LogFileCreationSchedule	로그 파일 이름에 포함할 날짜를 결정합니다.
MaxFileSize	로그 파일의 최대 허용 크기(바이트)를 가져오거나 설정합니다.
Name	이 TraceListener의 이름을 가져오거나 설정합니다. (다음에서 상속됨 TraceListener)
NeedIndent	출력의 들여쓰기 여부를 나타내는 값을 가져오거나 설정합니다. (다음에서 상속됨 TraceListener)
ReserveDiskSpace	메시지를 로그 파일에 쓰기 위해 필요한 사용 가능한 디스크 공간의 크기(바이트)를 가져오거나 설정합니다.
TraceOutputOptions	추적 출력 옵션을 가져오거나 설정합니다. (다음에서 상속됨 TraceListener)

메서드

Close()	현재 로그 파일의 내부 스트림을 닫고 현재 스트림과 관련된 모든 리소스를 해제합니다.
CreateObjRef(Type)	원격 개체와 통신하는 데 사용되는 프록시 생성에 필요한 모든 관련 정보가 들어 있는 개체를 만듭니다. (다음에서 상속됨 MarshalByRefObject)
Dispose()	TraceListener에서 사용하는 모든 리소스를 해제합니다. (다음에서 상속됨 TraceListener)
Dispose(Boolean)	내부 스트림을 닫고 관리되는 리소스를 선택적으로 해제합니다.
Equals(Object)	지정된 개체가 현재 개체와 같은지 확인합니다. (다음에서 상속됨 Object)
Fail(String)	TraceListener 클래스를 구현할 때 생성한 수신기에 오류 메시지를 내보냅니다. (다음에서 상속됨 TraceListener)
Fail(String, String)	TraceListener 클래스를 구현할 때 만든 수신기에 오류 메시지 및 자세한 오류 메시지를 내보냅니다. (다음에서 상속됨 TraceListener)
Flush()	현재 로그 파일에 쓰는 내부 스트림을 플러시합니다.
GetHashCode()	기본 해시 함수로 작동합니다. (다음에서 상속됨 Object)
GetLifetimeService()	사용되지 않음. 이 인스턴스의 수명 정책을 제어하는 현재의 수명 서비스 개체를 검색합니다. (다음에서 상속됨 MarshalByRefObject)
GetSupportedAttributes()	추적 수신기가 지원하는 사용자 지정 XML 구성 특성을 가져옵니다.
GetType()	현재 인스턴스의 Type을 가져옵니다. (다음에서 상속됨 Object)
InitializeLifetimeService()	사용되지 않음. 이 인스턴스의 수명 정책을 제어하는 수명 서비스 개체를 가져옵니다. (다음에서 상속됨 MarshalByRefObject)
MemberwiseClone()	현재 Object의 단순 복사본을 만듭니다. (다음에서 상속됨 Object)
MemberwiseClone(Boolean)	현재 MarshalByRefObject 개체의 단순 복사본을 만듭니다. (다음에서 상속됨 MarshalByRefObject)
ToString()	현재 개체를 나타내는 문자열을 반환합니다. (다음에서 상속됨 Object)
TraceData(TraceEventCache, String, TraceEventType, Int32, Object)	추적 정보, 데이터 개체 및 이벤트 정보를 출력 파일이나 스트림에 씁니다.
TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])	추적 정보, 데이터 개체의 배열 및 이벤트 정보를 출력 파일이나 스트림에 씁니다.
TraceEvent(TraceEventCache, String, TraceEventType, Int32)	추적 및 이벤트 정보를 수신기별 출력에 씁니다. (다음에서 상속됨 TraceListener)
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)	추적 정보, 메시지 및 이벤트 정보를 출력 파일이나 스트림에 씁니다.
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])	추적 정보, 형식 지정된 개체 배열 및 이벤트 정보를 출력 파일이나 스트림에 씁니다.
TraceTransfer(TraceEventCache, String, Int32, String, Guid)	추적 정보, 메시지, 관련 작업 ID 및 이벤트 정보를 수신기별 출력에 씁니다. (다음에서 상속됨 TraceListener)
Write(Object)	ToString() 클래스를 구현할 때 생성한 수신기에 개체의 TraceListener 메서드 값을 씁니다. (다음에서 상속됨 TraceListener)
Write(Object, String)	ToString() 클래스를 구현할 때 생성한 수신기에 범주 이름 및 개체의 TraceListener 메서드 값을 씁니다. (다음에서 상속됨 TraceListener)
Write(String)	추가 컨텍스트 정보 없이 디스크에 약어 메시지를 씁니다.
Write(String, String)	TraceListener 클래스를 구현할 때 생성한 수신기에 범주 이름 및 메시지를 씁니다. (다음에서 상속됨 TraceListener)
WriteIndent()	이 클래스를 구현할 때 생성한 수신기에 들여쓰기를 하고 NeedIndent 속성을 `false`로 다시 설정합니다. (다음에서 상속됨 TraceListener)
WriteLine(Object)	ToString() 클래스를 구현할 때 생성한 수신기에 개체의 TraceListener 메서드 값을 쓴 다음 줄 종결자를 씁니다. (다음에서 상속됨 TraceListener)
WriteLine(Object, String)	ToString() 클래스를 구현할 때 생성한 수신기에 범주 이름 및 개체의 TraceListener 메서드 값을 쓴 다음 줄 종결자를 씁니다. (다음에서 상속됨 TraceListener)
WriteLine(String)	추가 컨텍스트 정보 없이 디스크에 약어 메시지를 씁니다. 메시지 다음에는 현재 줄 종결자가 표시됩니다.
WriteLine(String, String)	TraceListener 클래스를 구현할 때 생성한 수신기에 범주 이름 및 메시지를 쓴 다음 줄 종결자를 씁니다. (다음에서 상속됨 TraceListener)

적용 대상

FileLogTraceListener 클래스

정의

설명

생성자

속성

메서드

적용 대상

추가 정보

피드백

추가 리소스