FileLogTraceListener.Append Propriedade

Definição

Namespace:

Microsoft.VisualBasic.Logging

Assembly:

Microsoft.VisualBasic.Forms.dll

Determina se a saída deve ser acrescentada ao arquivo atual ou gravada em um arquivo novo ou existente.

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

Valor da propriedade

Boolean

Boolean, com True indicando que a saída é acrescentada ao arquivo atual e False indicando que a saída é gravada em um novo arquivo. A configuração padrão dessa propriedade é True.

Comentários

Quando a Append propriedade é True, o arquivo de log é aberto no Append modo para manter os logs existentes. A posição de gravação atual começa no final do arquivo, de modo que todos os novos logs sejam acrescentados ao final do arquivo.

Quando a Append propriedade é False, o arquivo de log é aberto no modo , onde Truncate todos os dados de log são excluídos quando o arquivo de log é aberto. O FileLogTraceListener exclui o conteúdo existente do arquivo de log uma vez depois que o Append corretamente é definido False como ou o arquivo é aberto e antes de gravar o primeiro log. Depois disso, FileLogTraceListener acrescenta dados de rastreamento adicionais ao final do arquivo. Se a FileLogTraceListener instância for fechada e reaberta enquanto Append estiver definida como False, ela apagará os dados do arquivo de log antes de gravar logs adicionais. Isso pode levar a dados ausentes, especialmente se você definir o valor da Append propriedade como False em um arquivo de configuração.

Esse comportamento é substituído nos seguintes cenários:

• O arquivo de saída é bloqueado por outro processo. Um novo arquivo de log é criado com um número de versão incorporado ao FullLogFileName nome.

• O tamanho do arquivo atual é maior do que o permitido pela MaxFileSize propriedade. Mensagens adicionais são descartadas. Dependendo da DiskSpaceExhaustedBehavior propriedade , uma exceção é gerada.

• O nome do arquivo existente está desatualizado de acordo com o agendamento de criação de log especificado pela LogFileCreationSchedule propriedade . Um novo arquivo de log é criado. O carimbo de data é incorporado ao FullLogFileName nome.

Confira também

• MaxFileSize
• LogFileCreationSchedule