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 TraceLogRetentionOption
public enum TraceLogRetentionOption
type TraceLogRetentionOption =
Public Enum TraceLogRetentionOption
- Vererbung
Felder
LimitedCircularFiles | 1 | Eine endliche Anzahl sequenzieller Dateien, jeweils mit der maximalen Dateigröße. Wenn der MaximumFileSize-Eigenschaftswert erreicht wird, wird mit dem Schreiben in einer neuen Dateien mit einem inkrementierten ganzzahligen Suffix begonnen. Wenn der MaximumNumberOfFiles-Eigenschaftswert erreicht wird, wird die erste Datei gelöscht und überschrieben. Dateien werden dann inkrementell nach dem Rotationsprinzip überschrieben. |
LimitedSequentialFiles | 3 | Eine endliche Anzahl sequenzieller Dateien, jeweils mit der maximalen Dateigröße. Wenn der MaximumFileSize-Eigenschaftswert erreicht wird, wird mit dem Schreiben in einer neuen Dateien mit einem inkrementierten ganzzahligen Suffix begonnen. |
SingleFileBoundedSize | 4 | Eine einzelne Datei mit der maximalen, von der MaximumFileSize-Eigenschaft bestimmten Dateigröße. |
SingleFileUnboundedSize | 2 | Eine einzelne Datei ohne Beschränkung der maximalen Dateigröße. |
UnlimitedSequentialFiles | 0 | Eine unbegrenzte Anzahl sequenzieller Dateien, jeweils mit der maximalen, von der MaximumFileSize-Eigenschaft bestimmten Dateigröße. Es gilt keine logische Begrenzung hinsichtlich der Anzahl oder Größe der Dateien, jedoch bestehen physische Einschränkungen seitens des Computers. |
Hinweise
Die TraceLogRetentionOption Enumeration 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 Eigenschaften und EventSchemaTraceListener.MaximumNumberOfFiles .
Sie können die MaximumFileSize Eigenschaften und MaximumNumberOfFiles über die maximumFileSize
benutzerdefinierten Attribute und maximumNumberOfFiles
in der Konfigurationsdatei oder mithilfe der maximumFileSize
Parameter oder maximumNumberOfFiles
im EventSchemaTraceListener Konstruktor festlegen. Wenn die maximumFileSize
Attribute oder maximumNumberOfFiles
in der Konfigurationsdatei einen Wert außerhalb des Bereichs angeben, werden die Eigenschaften auf ihre Standardwerte festgelegt. Wenn Sie beim Aufrufen EventSchemaTraceListener des Konstruktors einen Wert außerhalb des maximumFileSize
Bereichs im Parameter oder maximumNumberOfFiles
angeben, wird ein ArgumentOutOfRangeException ausgelöst.
Die folgende Tabelle zeigt die möglichen und Standardwerte für Dateigröße und Dateianzahl, die jeder Aufbewahrungsoption für Ablaufverfolgungsprotokolle zugeordnet sind. "N/A" gibt an, dass die zugeordnete Eigenschaft nicht auf diesen TraceLogRetentionOption Wert überprüft wird.
Tracelogretentionoption | Maximale Dateigröße | Standarddateigröße | Maximale Anzahl von Dateien | Standardanzahl von Dateien |
---|---|---|---|---|
LimitedCircularFiles | Nicht zutreffend | -1 | Nicht zutreffend | 1 |
LimitedSequentialFiles | >0 | 4 kB | Nicht zutreffend | 1 |
SingleFileBoundedSize | >0 | 4 kB | Nicht zutreffend | -1 |
SingleFileUnboundedSize | >0 | 4 kB | >0 | 1 |
UnlimitedSequentialFiles | >0 | 4 kB | >1 | 2 |