FileLogTraceListener.Append Свойство

  • Ссылка

Определение

Пространство имен:
Microsoft.VisualBasic.Logging
Сборка:
Microsoft.VisualBasic.dll
Сборка:
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 существующее содержимое файла журнала один раз после Append установки False надлежащего значения или открытия файла и перед записью первого журнала. После этого FileLogTraceListener добавляет дополнительные данные трассировки в конец файла. FileLogTraceListener Если экземпляр закрывается, а затем повторно открывается, а для параметра Append задано значение False, данные файла журнала удаляются перед записью дополнительных журналов. Это может привести к отсутствовать данным, особенно если для свойства False задано Append значение в файле конфигурации.

Это поведение переопределяется в следующих сценариях:

  • Выходной файл заблокирован другим процессом. Создается новый файл журнала с номером версии, включенным FullLogFileName в имя .

  • Текущий размер файла больше, MaxFileSize чем позволяет свойство . Дополнительные сообщения удаляются. В зависимости DiskSpaceExhaustedBehavior от свойства возникает исключение.

  • Имя существующего файла устарело в соответствии с расписанием создания журнала, заданным свойством LogFileCreationSchedule . Создается новый файл журнала. Метка даты включается в FullLogFileName имя.

Применяется к

См. также раздел