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 arquivos que será usada para o log de EventSchemaTraceListener.
public enum class TraceLogRetentionOption
public enum TraceLogRetentionOption
type TraceLogRetentionOption =
Public Enum TraceLogRetentionOption
- Herança
Campos
| Nome | Valor | Description |
|---|---|---|
| UnlimitedSequentialFiles | 0 | Um número ilimitado de arquivos sequenciais, cada um com um tamanho máximo de arquivo determinado pela MaximumFileSize propriedade. Não há nenhum limite lógico para o número ou tamanho dos arquivos, mas ele é limitado pelas restrições físicas impostas pelo computador. |
| LimitedCircularFiles | 1 | Um número finito de arquivos sequenciais, cada um com um tamanho máximo de arquivo. Quando o valor da MaximumFileSize propriedade é atingido, a gravação começa em um novo arquivo com um sufixo inteiro incrementado. Quando o valor da MaximumNumberOfFiles propriedade é atingido, o primeiro arquivo é limpo e substituído. Em seguida, os arquivos são substituídos incrementalmente de maneira circular. |
| SingleFileUnboundedSize | 2 | Um arquivo sem restrição máxima de tamanho de arquivo. |
| LimitedSequentialFiles | 3 | Um número finito de arquivos sequenciais, cada um com um tamanho máximo de arquivo. Quando o valor da MaximumFileSize propriedade é atingido, a gravação começa em um novo arquivo com um sufixo inteiro incrementado. |
| SingleFileBoundedSize | 4 | Um arquivo com um tamanho máximo de arquivo determinado pela MaximumFileSize propriedade. |
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 propriedades e EventSchemaTraceListener.MaximumNumberOfFiles as EventSchemaTraceListener.MaximumFileSize propriedades.
Você pode definir as MaximumFileSize propriedades e MaximumNumberOfFiles por meio dos maximumFileSize atributos e maximumNumberOfFiles personalizados no arquivo de configuração ou usando os maximumFileSize parâmetros ou maximumNumberOfFiles no EventSchemaTraceListener construtor. Se os maximumFileSize atributos no maximumNumberOfFiles arquivo de configuração especificarem um valor fora do intervalo, as propriedades serão definidas como seus valores padrão. Se você especificar um valor fora do intervalo no parâmetro ou maximumNumberOfFiles quando maximumFileSize 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/A" 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/A | -1 | N/A | 1 |
| LimitedSequentialFiles | >0 | 4 kB | N/A | 1 |
| SingleFileBoundedSize | >0 | 4 kB | N/A | -1 |
| SingleFileUnboundedSize | >0 | 4 kB | >0 | 1 |
| UnlimitedSequentialFiles | >0 | 4 kB | >1 | 2 |