FileLogTraceListener.Append 속성

정의

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

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로 설정된 동안 인스턴스가 닫힌 후 다시 열리면 추가 로그를 작성하기 전에 로그 파일 데이터가 지워집니다. 따라서 특히 구성 파일에서 속성 값을 Append 설정하는 경우 데이터가 누락 될 False 수 있습니다.

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

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

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

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

적용 대상

추가 정보