TraceLogRetentionOption Enumerazione
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Specifica la struttura di file che verrà utilizzata per il log EventSchemaTraceListener.
public enum class TraceLogRetentionOptionpublic enum TraceLogRetentionOptiontype TraceLogRetentionOption = Public Enum TraceLogRetentionOption- Ereditarietà
Campi
| LimitedCircularFiles | 1 | Numero limitato di file sequenziali, ognuno con una dimensione massima di file. Quando viene raggiunto il valore della proprietà MaximumFileSize, la scrittura viene avviata in un nuovo file con un suffisso intero incrementato. Quando viene raggiunto il valore della proprietà MaximumNumberOfFiles, il primo file viene cancellato e sovrascritto. I file vengono quindi sovrascritti con criterio incrementale in modo circolare. |
| LimitedSequentialFiles | 3 | Numero limitato di file sequenziali, ognuno con una dimensione massima di file. Quando viene raggiunto il valore della proprietà MaximumFileSize, la scrittura viene avviata in un nuovo file con un suffisso intero incrementato. |
| SingleFileBoundedSize | 4 | File con una dimensione massima determinata dalla proprietà MaximumFileSize. |
| SingleFileUnboundedSize | 2 | File senza restrizioni di dimensione massima. |
| UnlimitedSequentialFiles | 0 | Numero illimitato di file sequenziali, ognuno con una dimensione massima di file determinata dalla proprietà MaximumFileSize. Non esistono limiti logici al numero o alla dimensione dei file, ma i limiti vengono stabiliti dai vincoli fisici imposti dal computer. |
Commenti
TraceLogRetentionOptionL'enumerazione viene utilizzata per specificare il valore della proprietà nella classe TraceLogRetentionOption EventSchemaTraceListener . Tale impostazione di proprietà determina i valori possibili e predefiniti per le EventSchemaTraceListener.MaximumFileSize proprietà EventSchemaTraceListener.MaximumNumberOfFiles e .
È possibile impostare le proprietà e tramite gli attributi personalizzati e nel file di configurazione oppure MaximumFileSize usando i parametri o nel costruttore MaximumNumberOfFiles maximumFileSize maximumNumberOfFiles maximumFileSize maximumNumberOfFiles EventSchemaTraceListener . Se gli attributi o nel file di configurazione specificano un valore non compreso nell'intervallo, le proprietà maximumFileSize vengono impostate sui valori maximumNumberOfFiles predefiniti. Se si specifica un valore non compreso nell'intervallo nel parametro o quando si maximumFileSize maximumNumberOfFiles chiama il EventSchemaTraceListener costruttore, viene generata ArgumentOutOfRangeException un'eccezione .
Nella tabella seguente vengono illustrati i valori possibili e predefiniti per le dimensioni dei file e il numero di file associati a ogni opzione di conservazione del log di traccia. "N/D" indica che per la proprietà associata non viene verificato tale valore di TraceLogRetentionOption.
| Tracelogretentionoption | Dimensione massima dei file | Dimensioni file predefinite | Numero massimo di file | Numero predefinito di file |
|---|---|---|---|---|
| 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 |