TraceLogRetentionOption Enumeração
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Especifica a estrutura do ficheiro que será usada para o EventSchemaTraceListener log.
public enum class TraceLogRetentionOptionpublic enum TraceLogRetentionOptiontype TraceLogRetentionOption = Public Enum TraceLogRetentionOption- Herança
Campos
| Name | Valor | Description |
|---|---|---|
| UnlimitedSequentialFiles | 0 | Um número ilimitado de ficheiros sequenciais, cada um com um tamanho máximo de ficheiro determinado pela MaximumFileSize propriedade. Não existe um limite lógico ao número ou tamanho dos ficheiros, mas é limitado pelas restrições físicas impostas pelo computador. |
| LimitedCircularFiles | 1 | Um número finito de ficheiros sequenciais, cada um com um tamanho máximo de ficheiro. Quando o MaximumFileSize valor da propriedade é atingido, a escrita começa num novo ficheiro com um sufixo inteiro incrementado. Quando o MaximumNumberOfFiles valor da propriedade é atingido, o primeiro ficheiro é limpo e sobrescrevido. Os ficheiros são então sobrescritos incrementalmente de forma circular. |
| SingleFileUnboundedSize | 2 | Um ficheiro sem restrição de tamanho máximo de ficheiro. |
| LimitedSequentialFiles | 3 | Um número finito de ficheiros sequenciais, cada um com um tamanho máximo de ficheiro. Quando o MaximumFileSize valor da propriedade é atingido, a escrita começa num novo ficheiro com um sufixo inteiro incrementado. |
| SingleFileBoundedSize | 4 | Um ficheiro com um tamanho máximo determinado pela MaximumFileSize propriedade. |
Observações
A TraceLogRetentionOption enumeração é usada para especificar o valor da TraceLogRetentionOption propriedade na EventSchemaTraceListener classe. Essa definição de propriedade determina os valores possíveis e padrão para as EventSchemaTraceListener.MaximumFileSize propriedades e EventSchemaTraceListener.MaximumNumberOfFiles .
Pode definir as MaximumFileSize propriedades and MaximumNumberOfFiles através dos maximumFileSize atributos e maximumNumberOfFiles personalizados no ficheiro de configuração ou usando os maximumFileSize parâmetros or maximumNumberOfFiles no EventSchemaTraceListener construtor. Se os maximumFileSize atributos ou maximumNumberOfFiles no ficheiro de configuração especificarem um valor fora de intervalo, as propriedades são definidas para os seus valores predefinidos. Se especificar um valor fora de intervalo no maximumFileSize parâmetro ou maximumNumberOfFiles ao chamar o EventSchemaTraceListener construtor, um ArgumentOutOfRangeException é lançado.
A tabela seguinte mostra os valores possíveis e por defeito para tamanho e contagem de ficheiros associados a cada opção de retenção de registo de traços. "N/A" indica que a propriedade associada não está verificada para esse TraceLogRetentionOption valor.
| TraceLogRetentionOption | Tamanho máximo do ficheiro | Tamanho padrão do ficheiro | Número máximo de ficheiros | Número padrão de ficheiros |
|---|---|---|---|---|
| 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 |