TraceLogRetentionOption Enum
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Anger den filstruktur som ska användas för loggen EventSchemaTraceListener .
public enum class TraceLogRetentionOptionpublic enum TraceLogRetentionOptiontype TraceLogRetentionOption = Public Enum TraceLogRetentionOption- Arv
Fält
| Name | Värde | Description |
|---|---|---|
| UnlimitedSequentialFiles | 0 | Ett obegränsat antal sekventiella filer, var och en med en maximal filstorlek som bestäms av MaximumFileSize egenskapen. Det finns ingen logisk bindning till antalet eller storleken på filerna, men det begränsas av de fysiska begränsningar som datorn har infört. |
| LimitedCircularFiles | 1 | Ett begränsat antal sekventiella filer, var och en med en maximal filstorlek. När egenskapsvärdet MaximumFileSize har nåtts börjar skrivning i en ny fil med ett inkrementerat heltalssuffix. När egenskapsvärdet MaximumNumberOfFiles har nåtts rensas och skrivs den första filen över. Filer skrivs sedan över stegvis på ett cirkulärt sätt. |
| SingleFileUnboundedSize | 2 | En fil utan maximal filstorleksbegränsning. |
| LimitedSequentialFiles | 3 | Ett begränsat antal sekventiella filer, var och en med en maximal filstorlek. När egenskapsvärdet MaximumFileSize har nåtts börjar skrivning i en ny fil med ett inkrementerat heltalssuffix. |
| SingleFileBoundedSize | 4 | En fil med en maximal filstorlek som bestäms av egenskapen MaximumFileSize . |
Kommentarer
Uppräkningen TraceLogRetentionOption används för att ange värdet för TraceLogRetentionOption egenskapen i EventSchemaTraceListener klassen. Den här egenskapsinställningen bestämmer möjliga och standardvärden för EventSchemaTraceListener.MaximumFileSize egenskaperna och EventSchemaTraceListener.MaximumNumberOfFiles .
Du kan ange MaximumFileSize egenskaperna och MaximumNumberOfFiles via de anpassade maximumNumberOfFiles attributen maximumFileSize i konfigurationsfilen eller med hjälp av parametrarna maximumFileSize eller maximumNumberOfFiles i EventSchemaTraceListener konstruktorn. Om attributen maximumFileSize eller maximumNumberOfFiles i konfigurationsfilen anger ett out-of-range-värde anges egenskaperna till deras standardvärden. Om du anger ett out-of-range-värde i parametern maximumFileSize eller maximumNumberOfFiles när du anropar EventSchemaTraceListener konstruktorn genereras en ArgumentOutOfRangeException .
I följande tabell visas möjliga och standardvärden för filstorlek och filantal som är associerade med varje kvarhållningsalternativ för spårningsloggar. "N/A" anger att den associerade egenskapen inte är markerad för det TraceLogRetentionOption värdet.
| TraceLogRetentionOption | Största filstorlek | Standardfilstorlek | Maximalt antal filer | Standardantal filer |
|---|---|---|---|---|
| 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 |