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
L'enumerazione TraceLogRetentionOptionTraceLogRetentionOption viene usata per specificare il valore della proprietà nella EventSchemaTraceListener classe . L'impostazione della proprietà determina i valori possibili e predefiniti per le EventSchemaTraceListener.MaximumFileSize proprietà e EventSchemaTraceListener.MaximumNumberOfFiles .
È possibile impostare le MaximumFileSize proprietà e tramite gli maximumFileSize attributi personalizzati maximumNumberOfFilesMaximumNumberOfFiles nel file di configurazione o usando i maximumFileSize parametri o maximumNumberOfFiles nel EventSchemaTraceListener costruttore. Se gli maximumFileSize attributi o maximumNumberOfFiles nel file di configurazione specificano un valore out-of-range, le proprietà vengono impostate sui valori predefiniti. Se si specifica un valore out-of-range nel maximumFileSize parametro o maximumNumberOfFiles quando si chiama il EventSchemaTraceListener costruttore, viene generato un ArgumentOutOfRangeException valore.
La tabella seguente mostra i valori possibili e predefiniti per le dimensioni e il numero di file associati a ogni opzione di conservazione dei log di traccia. "N/D" indica che per la proprietà associata non viene verificato tale valore di TraceLogRetentionOption.
| Tracelogretentionoption | Dimensione massima dei file | Dimensioni predefinite del file | 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 |
