Share via

FileLogTraceListener.Append Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
Microsoft.VisualBasic.Logging
Zestaw:
Microsoft.VisualBasic.dll
Zestaw:
Microsoft.VisualBasic.Forms.dll

Określa, czy dane wyjściowe mają być dołączane do bieżącego pliku, czy zapisywane w nowym lub istniejącym pliku.

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

Wartość właściwości

Boolean

Booleanz wskazującym True , że dane wyjściowe są dołączane do bieżącego pliku i False wskazują, że dane wyjściowe są zapisywane w nowym pliku. Ustawieniem domyślnym dla tej właściwości jest True.

Uwagi

Gdy Append właściwość ma Truewartość , plik dziennika jest otwarty w Append trybie, aby zachować istniejące dzienniki. Bieżące położenie zapisu rozpoczyna się na końcu pliku, tak aby wszystkie nowe dzienniki zostały dołączone na końcu pliku.

Gdy Append właściwość ma Falsewartość , plik dziennika jest otwierany w Truncate trybie, w którym wszystkie dane dziennika są usuwane po otwarciu pliku dziennika. Obiekt FileLogTraceListener usuwa istniejącą zawartość pliku dziennika po ustawieniu odpowiedniego Append elementu lub False otwarciu pliku i przed zapisem pierwszego dziennika. FileLogTraceListener Następnie dołącza dodatkowe dane śledzenia na końcu pliku. FileLogTraceListener Jeśli wystąpienie zostanie zamknięte, a następnie ponownie otwarte podczas dołączania ma wartość False, usuwa dane pliku dziennika przed zapisaniem dodatkowych dzienników. Może to prowadzić do braku danych, szczególnie w przypadku ustawienia wartości Append właściwości False na wartość w pliku konfiguracji.

To zachowanie jest zastępowane w następujących scenariuszach:

  • Plik wyjściowy jest zablokowany przez inny proces. Zostanie utworzony nowy plik dziennika z numerem wersji, który jest uwzględniony w FullLogFileName nazwie.

  • Bieżący rozmiar pliku jest większy niż wartość MaxFileSize właściwości. Dodatkowe komunikaty są odrzucane. W zależności DiskSpaceExhaustedBehavior od właściwości zgłaszany jest wyjątek.

  • Istniejąca nazwa pliku jest nieaktualna zgodnie z harmonogramem LogFileCreationSchedule tworzenia dziennika określonym przez właściwość . Zostanie utworzony nowy plik dziennika. Sygnatura daty jest włączona FullLogFileName do nazwy.

Dotyczy

Zobacz też