FileLogTraceListener.Append Propriété

  • Référence

Définition

Espace de noms:
Microsoft.VisualBasic.Logging
Assembly:
Microsoft.VisualBasic.dll
Assembly:
Microsoft.VisualBasic.Forms.dll

Détermine s’il convient d’ajouter la sortie au fichier en cours ou de l’écrire dans un fichier nouveau ou existant.

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

Valeur de propriété

Boolean

Boolean, avec True indiquant que la sortie est ajoutée au fichier en cours et False indiquant que la sortie est écrite dans un nouveau fichier. Le paramètre par défaut de cette propriété est True.

Remarques

Lorsque la propriété a la Append valeur True, le fichier journal est ouvert en Append mode pour conserver les journaux existants. La position d’écriture actuelle commence à la fin du fichier, de sorte que tous les nouveaux journaux sont ajoutés à la fin du fichier.

Lorsque la propriété a la Append valeur False, le fichier journal est ouvert en Truncate mode, où toutes les données du journal sont supprimées lors de l’ouverture du fichier journal. Le FileLogTraceListener supprime le contenu existant du fichier journal une fois après que le Append nom approprié est défini False sur ou que le fichier est ouvert et avant qu’il n’écrive le premier journal. Après cela, FileLogTraceListener ajoute des données de trace supplémentaires à la fin du fichier. Si le FileLogTraceListener instance est fermé, puis rouvert alors que Append a la valeur False, il efface les données du fichier journal avant d’écrire des journaux supplémentaires. Cela peut entraîner des données manquantes, en particulier si vous définissez la valeur de la Append propriété False sur dans un fichier de configuration.

Ce comportement est remplacé dans les scénarios suivants :

  • Le fichier de sortie est verrouillé par un autre processus. Un nouveau fichier journal est créé avec un numéro de version incorporé dans le FullLogFileName nom.

  • La taille de fichier actuelle est supérieure à ce que la MaxFileSize propriété autorise. Les messages supplémentaires sont ignorés. Selon la DiskSpaceExhaustedBehavior propriété, une exception est levée.

  • Le nom de fichier existant est obsolète conformément à la planification de création de journal spécifiée par la LogFileCreationSchedule propriété . Un fichier journal est créé. L’horodatage est incorporé dans le FullLogFileName nom.

S’applique à

Voir aussi