FileLogTraceListener.Append Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Určuje, zda se má výstup připojit k aktuálnímu souboru nebo ho zapsat do nového nebo existujícího souboru.
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 BooleanHodnota vlastnosti
Boolean, která True označuje, že výstup je připojen k aktuálnímu souboru a False označuje, že výstup je zapsán do nového souboru. Výchozí nastavení této vlastnosti je True.
Poznámky
Append Pokud je Truevlastnost , soubor protokolu se otevře v Append režimu, aby se zachovaly existující protokoly. Aktuální pozice zápisu začíná na konci souboru, takže všechny nové protokoly jsou připojeny na konec souboru.
Append Pokud je Falsevlastnost , soubor protokolu se otevře v Truncate režimu, kdy se při otevření souboru protokolu odstraní všechna data protokolu. Odstraní FileLogTraceListener existující obsah souboru protokolu jednou po Append nastavení False vlastního souboru nebo otevření souboru a před zápisem prvního protokolu. Poté FileLogTraceListener připojí další data trasování na konec souboru. FileLogTraceListener Pokud je instance zavřená a pak znovu otevřená, zatímco je možnost Připojit nastavená na hodnotu False, vymaže data souboru protokolu před zápisem dalších protokolů. To může vést k chybějícím datům, zejména pokud v konfiguračním souboru nastavíte hodnotu Append vlastnosti na False .
Toto chování je přepsáno v následujících scénářích:
Výstupní soubor je uzamčen jiným procesem. Vytvoří se nový soubor protokolu s číslem verze, které je začleněno do FullLogFileName názvu.
Aktuální velikost souboru je větší, než umožňuje MaxFileSize vlastnost. Další zprávy se zahodí. V závislosti na DiskSpaceExhaustedBehavior vlastnosti dojde k výjimce.
Stávající název souboru je zastaralý podle plánu vytváření protokolu určeného LogFileCreationSchedule vlastností. Vytvoří se nový soubor protokolu. Razítko data je začleněno do FullLogFileName názvu.
