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 TraceLogRetentionOptionpublic enum TraceLogRetentionOptiontype 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 |
