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
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.
