FileLogTraceListener.Append Свойство

Определение

Пространство имен:

Microsoft.VisualBasic.Logging

Сборка:

Microsoft.VisualBasic.Forms.dll

Исходный код:

FileLogTraceListener.vb

Определяет, следует ли добавлять выходные данные в текущий файл или записывать его в новый или существующий файл.

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

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

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

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

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

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

• MaxFileSize
• LogFileCreationSchedule