FileLogTraceListener.Append Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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, setPublic Property Append As BooleanValor da propriedade
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.
