FileLogTraceListener.Append Vlastnost

Definice

Obor názvů:

Microsoft.VisualBasic.Logging

Sestavení:

Microsoft.VisualBasic.Forms.dll

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

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.

Viz také

• MaxFileSize
• LogFileCreationSchedule