TraceLogRetentionOption Enumeração
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.
Especifica a estrutura de arquivo que será usada para o log EventSchemaTraceListener.
public enum class TraceLogRetentionOption
public enum TraceLogRetentionOption
type TraceLogRetentionOption =
Public Enum TraceLogRetentionOption
- Herança
Campos
LimitedCircularFiles | 1 | Um número finito de arquivos sequenciais, cada um com um tamanho máximo de arquivo. Quando o valor da propriedade MaximumFileSize é atingido, a gravação começa em um novo arquivo com um sufixo inteiro incrementado. Quando o valor da propriedade MaximumNumberOfFiles é alcançado, o primeiro arquivo é limpo e substituído. Os arquivos são, então, incrementalmente substituídos de forma circular. |
LimitedSequentialFiles | 3 | Um número finito de arquivos sequenciais, cada um com um tamanho máximo de arquivo. Quando o valor da propriedade MaximumFileSize é atingido, a gravação começa em um novo arquivo com um sufixo inteiro incrementado. |
SingleFileBoundedSize | 4 | Um arquivo com um tamanho máximo do arquivo determinado pela propriedade MaximumFileSize. |
SingleFileUnboundedSize | 2 | Um arquivo sem restrição de tamanho máximo do arquivo. |
UnlimitedSequentialFiles | 0 | Um número ilimitado de arquivos sequenciais, cada um com um tamanho do arquivo máximo que é determinado pela propriedade MaximumFileSize. Não há nenhum limite lógico para o número ou o tamanho dos arquivos, mas ele é limitado pelas restrições físicas impostas pelo computador. |
Comentários
A TraceLogRetentionOption enumeração é usada para especificar o valor da TraceLogRetentionOption propriedade na EventSchemaTraceListener classe . Essa configuração de propriedade determina os valores possíveis e padrão para as EventSchemaTraceListener.MaximumFileSize propriedades e EventSchemaTraceListener.MaximumNumberOfFiles .
Você pode definir as MaximumFileSize propriedades e MaximumNumberOfFiles por meio dos maximumFileSize
atributos personalizados e maximumNumberOfFiles
no arquivo de configuração ou usando os maximumFileSize
parâmetros ou maximumNumberOfFiles
no EventSchemaTraceListener construtor. Se os maximumFileSize
atributos ou maximumNumberOfFiles
no arquivo de configuração especificarem um valor fora do intervalo, as propriedades serão definidas com seus valores padrão. Se você especificar um valor fora do intervalo no maximumFileSize
parâmetro ou maximumNumberOfFiles
ao chamar o EventSchemaTraceListener construtor, um ArgumentOutOfRangeException será gerado.
A tabela a seguir mostra os valores possíveis e padrão para o tamanho do arquivo e a contagem de arquivos associados a cada opção de retenção de log de rastreamento. "N/D" indica que a propriedade associada não está marcada para esse TraceLogRetentionOption valor.
Tracelogretentionoption | Tamanho máximo do arquivo | Tamanho do arquivo padrão | Número máximo de arquivos | Número padrão de arquivos |
---|---|---|---|---|
LimitedCircularFiles | N/D | -1 | N/D | 1 |
LimitedSequentialFiles | >0 | 4 kB | N/D | 1 |
SingleFileBoundedSize | >0 | 4 kB | N/D | -1 |
SingleFileUnboundedSize | >0 | 4 kB | >0 | 1 |
UnlimitedSequentialFiles | >0 | 4 kB | >1 | 2 |