FileLogTraceListener.Append 속성

정의

네임스페이스:

Microsoft.VisualBasic.Logging

어셈블리:

Microsoft.VisualBasic.Forms.dll

현재 파일에 출력을 추가할지 또는 새 파일이나 기존 파일에 출력을 쓸지 여부를 결정합니다.

public:
 property bool Append { bool get(); void set(bool value); };

public bool Append { get; set; }

member this.Append : bool with get, set

Public Property Append As Boolean

속성 값

Boolean

Boolean. True는 출력이 현재 파일에 추가됨을 나타내고 False는 출력이 새 파일에 쓰여짐을 나타냅니다. 이 속성의 기본 설정은 True입니다.

설명

속성이 Append 이 True면 기존 로그를 유지하기 위해 로그 파일이 모드로 Append 열립니다. 현재 쓰기 위치는 파일의 끝에서 시작되므로 파일 끝에 새 로그가 추가됩니다.

속성이 Append 이 False면 로그 파일이 모드로 Truncate 열리고 로그 파일이 열릴 때 모든 로그 데이터가 삭제됩니다. 는 FileLogTraceListener 적절한 가 로 설정 False 되거나 파일이 열리고 첫 번째 로그를 쓰기 전에 로그 파일의 기존 콘텐츠를 한 번 Append 삭제합니다. 그런 다음 파일 FileLogTraceListener 끝에 추가 추적 데이터를 추가합니다. 추가가 FileLogTraceListener False로 설정된 동안 instance 닫힌 다음 다시 열면 추가 로그를 작성하기 전에 로그 파일 데이터가 지워집니다. 특히 구성 파일에서 속성 False 값을 Append 로 설정하는 경우 데이터가 누락 될 수 있습니다.

이 동작은 다음 시나리오에서 재정의됩니다.

• 출력 파일은 다른 프로세스에 의해 잠깁니다. 이름에 통합된 FullLogFileName 버전 번호로 새 로그 파일이 만들어집니다.

• 현재 파일 크기는 속성이 MaxFileSize 허용하는 크기보다 큽니다. 추가 메시지는 삭제됩니다. 속성에 DiskSpaceExhaustedBehavior 따라 예외가 throw됩니다.

• 기존 파일 이름은 속성에 지정된 로그 생성 일정에 따라 만료되었습니다 LogFileCreationSchedule . 새 로그 파일이 만들어집니다. 날짜 스탬프는 이름에 FullLogFileName 통합됩니다.

추가 정보

• MaxFileSize
• LogFileCreationSchedule