Sdílet prostřednictvím


FileLogTraceListener.Append Vlastnost

Definice

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, set
Public Property Append As Boolean

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

Platí pro

Viz také