FileLogTraceListener.Append Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Определяет, следует ли добавить выходные данные в текущий файл или следует записать их в новый или существующий файл.
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 надлежащего значения или открытия файла и перед записью первого журнала. После этого FileLogTraceListener добавляет дополнительные данные трассировки в конец файла. FileLogTraceListener Если экземпляр закрывается, а затем повторно открывается, а для параметра Append задано значение False, данные файла журнала удаляются перед записью дополнительных журналов. Это может привести к отсутствовать данным, особенно если для свойства False задано Append значение в файле конфигурации.
Это поведение переопределяется в следующих сценариях:
Выходной файл заблокирован другим процессом. Создается новый файл журнала с номером версии, включенным FullLogFileName в имя .
Текущий размер файла больше, MaxFileSize чем позволяет свойство . Дополнительные сообщения удаляются. В зависимости DiskSpaceExhaustedBehavior от свойства возникает исключение.
Имя существующего файла устарело в соответствии с расписанием создания журнала, заданным свойством LogFileCreationSchedule . Создается новый файл журнала. Метка даты включается в FullLogFileName имя.
