FileLogTraceListener.Append プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
出力を現在のファイルに追加するか、新規または既存のファイルに書き込むかを決定します。
public:
property bool Append { bool get(); void set(bool value); };public bool Append { get; set; }member this.Append : bool with get, setPublic Property Append As Booleanプロパティ値
Booleanは、出力が現在のファイルに追加されることを示す True と、出力が新しいファイルに書き込まれたことを示 False 。 このプロパティの既定の設定は Trueです。
注釈
Append プロパティがTrueされると、ログ ファイルはAppend モードで開き、既存のログを保持します。 現在の書き込み位置はファイルの末尾から始まり、新しいログがファイルの末尾に追加されます。
Append プロパティがFalseされると、ログ ファイルはTruncate モードで開かれます。このモードでは、ログ ファイルを開いたときにすべてのログ データが削除されます。
FileLogTraceListenerは、AppendのプロパティをFalseに設定するか、ファイルを開いた後、最初のログを書き込む前に、ログ ファイルの既存の内容を 1 回削除します。 その後、 FileLogTraceListener は追加のトレース データをファイルの末尾に追加します。 追加が False に設定されているときに FileLogTraceListener インスタンスが閉じられ、再度開かれた場合は、追加のログを書き込む前にログ ファイル データが消去されます。 これは、特に Append プロパティの値を構成ファイルで False に設定した場合に、データが不足する可能性があります。
この動作は、次のシナリオでオーバーライドされます。
出力ファイルは別のプロセスによってロックされます。 FullLogFileName名に組み込まれたバージョン番号を使用して、新しいログ ファイルが作成されます。
現在のファイル サイズは、 MaxFileSize プロパティで許可されているサイズを超えています。 追加のメッセージは破棄されます。 DiskSpaceExhaustedBehavior プロパティに応じて、例外がスローされます。
LogFileCreationSchedule プロパティで指定されたログ作成スケジュールに従って、既存のファイル名が古くなっている。 新しいログ ファイルが作成されます。 日付スタンプは、 FullLogFileName 名に組み込まれます。
