TraceLogRetentionOption Enumeration
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Gibt die Dateistruktur an, die für das EventSchemaTraceListener-Protokoll verwendet wird.
public enum class TraceLogRetentionOptionpublic enum TraceLogRetentionOptiontype TraceLogRetentionOption = Public Enum TraceLogRetentionOption- Vererbung
Felder
| Name | Wert | Beschreibung |
|---|---|---|
| UnlimitedSequentialFiles | 0 | Eine unbegrenzte Anzahl sequenzieller Dateien mit einer maximalen Dateigröße, die von der MaximumFileSize Eigenschaft bestimmt wird. Es gibt keine logische Bindung an die Anzahl oder Größe der Dateien, aber sie ist durch die physischen Einschränkungen beschränkt, die vom Computer auferlegt werden. |
| LimitedCircularFiles | 1 | Eine endliche Anzahl sequenzieller Dateien, die jeweils eine maximale Dateigröße aufweisen. Wenn der Eigenschaftswert erreicht ist, beginnt das MaximumFileSize Schreiben in einer neuen Datei mit einem inkrementierten ganzzahligen Suffix. Wenn der MaximumNumberOfFiles Eigenschaftswert erreicht ist, wird die erste Datei gelöscht und überschrieben. Dateien werden dann inkrementell in zirkulärer Weise überschrieben. |
| SingleFileUnboundedSize | 2 | Eine Datei ohne maximale Dateigrößeneinschränkung. |
| LimitedSequentialFiles | 3 | Eine endliche Anzahl sequenzieller Dateien, die jeweils eine maximale Dateigröße aufweisen. Wenn der Eigenschaftswert erreicht ist, beginnt das MaximumFileSize Schreiben in einer neuen Datei mit einem inkrementierten ganzzahligen Suffix. |
| SingleFileBoundedSize | 4 | Eine Datei mit einer maximalen Dateigröße, die von der MaximumFileSize Eigenschaft bestimmt wird. |
Hinweise
Die TraceLogRetentionOption Aufzählung wird verwendet, um den Wert der TraceLogRetentionOption Eigenschaft in der EventSchemaTraceListener Klasse anzugeben. Diese Eigenschaftseinstellung bestimmt die möglichen und Standardwerte für die EventSchemaTraceListener.MaximumFileSize und EventSchemaTraceListener.MaximumNumberOfFiles die Eigenschaften.
Sie können die MaximumFileSize Eigenschaften über MaximumNumberOfFiles die und maximumNumberOfFiles die maximumFileSize benutzerdefinierten Attribute in der Konfigurationsdatei oder mithilfe der maximumFileSize Parameter maximumNumberOfFiles im EventSchemaTraceListener Konstruktor festlegen. Wenn die maximumFileSize Oder-Attribute maximumNumberOfFiles in der Konfigurationsdatei einen Out-of-Range-Wert angeben, werden die Eigenschaften auf ihre Standardwerte festgelegt. Wenn Sie beim Aufrufen des EventSchemaTraceListener Konstruktors einen Out-of-Range-Wert angeben maximumFileSizemaximumNumberOfFiles, wird ein ArgumentOutOfRangeException Fehler ausgelöst.
In der folgenden Tabelle sind die möglichen und Standardwerte für Dateigröße und Dateianzahl aufgeführt, die jeder Aufbewahrungsoption für Ablaufverfolgungsprotokolle zugeordnet sind. "N/A" gibt an, dass die zugeordnete Eigenschaft für diesen TraceLogRetentionOption Wert nicht überprüft wird.
| Tracelogretentionoption | Maximale Dateigröße | Standarddateigröße | Maximale Anzahl von Dateien | Standardanzahl von Dateien |
|---|---|---|---|---|
| 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 |
