FileLogTraceListener.Append Właściwość
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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, setPublic Property Append As BooleanWartość właściwości
Boolean, wskazując 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ść to True, plik dziennika jest otwarty w Append trybie, aby zachować istniejące dzienniki. Bieżące położenie zapisu rozpoczyna się na końcu pliku, dzięki czemu wszystkie nowe dzienniki są dołączane 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. Element FileLogTraceListener usuwa istniejącą zawartość pliku dziennika raz po Append ustawieniu odpowiedniego elementu lub False plik jest otwierany i przed zapisaniem 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 na False 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 dołączonym FullLogFileName do nazwy.
Bieżący rozmiar pliku jest większy niż dozwolony dla 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 dołączana do FullLogFileName nazwy.
