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 jej 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
Booleans uvedením True , že výstup je připojen k aktuálnímu souboru a False indikuje, že výstup je zapsán do nového souboru. Výchozí nastavení této vlastnosti je True.
Poznámky
Append Pokud je Truetato vlastnost , soubor protokolu je otevřen v Append režimu, aby se zachovaly existující protokoly. Aktuální pozice zápisu začíná na konci souboru, aby se všechny nové protokoly připojily na konec souboru.
Při vlastnosti AppendFalseje soubor protokolu otevřen v Truncate režimu, kde se při otevření souboru protokolu odstraní všechna data protokolu. Odstraní FileLogTraceListener existující obsah souboru protokolu jednou po Append nastavení False nebo otevření souboru a před zápisem prvního protokolu.
FileLogTraceListener Potom připojí další data trasování na konec souboru.
FileLogTraceListener Pokud je instance zavřená a poté znovu otevřena, když je připojení nastaveno na 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 nastavíte hodnotu Append vlastnosti v False konfiguračním souboru.
Toto chování se přepíše 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 součástí FullLogFileName názvu.
Aktuální velikost souboru je větší než to, co MaxFileSize vlastnost umožňuje. Další zprávy se zahodí. V závislosti na DiskSpaceExhaustedBehavior vlastnosti je vyvolán výjimka.
Název existujícího souboru je zastaralý podle plánu vytvoření protokolu určeného LogFileCreationSchedule vlastností. Vytvoří se nový soubor protokolu. Razítko data je začleněno do FullLogFileName názvu.
