次の方法で共有


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 値。現在のファイルに追記する場合は True。新しいファイルに出力する場合は False。 このプロパティの既定の設定は True です。

注釈

プロパティが Append の場合、 Trueログ ファイルはモードで開き、既存の Append ログを保持します。 現在の書き込み位置はファイルの末尾から始まり、新しいログがファイルの末尾に追加されます。

プロパティが AppendFalseの場合、ログ ファイルはモードで開かれます。このモードでは Truncate 、ログ ファイルを開いたときにすべてのログ データが削除されます。 は FileLogTraceListener 、適切性が に設定された後、またはファイルが Append 開かれた後、最初のログを False 書き込む前に、ログ ファイルの既存の内容を 1 回削除します。 その後、 FileLogTraceListener 追加のトレース データをファイルの末尾に追加します。 Append が FileLogTraceListener False に設定されている間にインスタンスが閉じられ、再度開かれた場合は、追加のログを書き込む前にログ ファイル データが消去されます。 これにより、特に構成ファイルで プロパティの値を にFalse設定した場合、データがAppend不足する可能性があります。

この動作は、次のシナリオでオーバーライドされます。

  • 出力ファイルは別のプロセスによってロックされます。 名前に組み込まれたバージョン番号を使用して、新しいログ ファイルが FullLogFileName 作成されます。

  • 現在のファイル サイズは、 プロパティで許可されている MaxFileSize サイズを超えています。 追加のメッセージは破棄されます。 プロパティに DiskSpaceExhaustedBehavior 応じて、例外がスローされます。

  • 既存のファイル名は、 プロパティで LogFileCreationSchedule 指定されたログ作成スケジュールに従って最新ではありません。 新しいログ ファイルが作成されます。 日付スタンプが名前に FullLogFileName 組み込まれます。

適用対象

こちらもご覧ください