TraceLogRetentionOption Výčet
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Určuje strukturu souborů, která se použije pro EventSchemaTraceListener protokol.
public enum class TraceLogRetentionOption
public enum TraceLogRetentionOption
type TraceLogRetentionOption =
Public Enum TraceLogRetentionOption
- Dědičnost
Pole
LimitedCircularFiles | 1 | Konečný počet sekvenčních souborů, každý s maximální velikostí souboru. Po dosažení MaximumFileSize hodnoty vlastnosti začne zápis do nového souboru s příponou integer. Při dosažení MaximumNumberOfFiles hodnoty vlastnosti se první soubor vymaže a přepíše. Soubory se pak postupně cyklickém způsobem přepisují. |
LimitedSequentialFiles | 3 | Konečný počet sekvenčních souborů, každý s maximální velikostí souboru. Po dosažení MaximumFileSize hodnoty vlastnosti začne zápis do nového souboru s příponou integer. |
SingleFileBoundedSize | 4 | Jeden soubor s maximální velikostí, která je určena MaximumFileSize vlastností . |
SingleFileUnboundedSize | 2 | Jeden soubor bez omezení maximální velikosti souboru. |
UnlimitedSequentialFiles | 0 | Neomezený počet sekvenčních souborů, z nichž každý má maximální velikost určenou MaximumFileSize vlastností . Počet nebo velikost souborů není nijak logický vázaný, ale je omezený fyzickými omezeními, která nařizují počítače. |
Poznámky
Výčet TraceLogRetentionOption slouží k určení hodnoty TraceLogRetentionOption vlastnosti ve EventSchemaTraceListener třídě . Toto nastavení vlastnosti určuje možné a výchozí hodnoty vlastností EventSchemaTraceListener.MaximumFileSize a EventSchemaTraceListener.MaximumNumberOfFiles .
Vlastnosti a můžete nastavit MaximumFileSize prostřednictvím maximumFileSize
vlastních atributů a maximumNumberOfFiles
v konfiguračním souboru nebo pomocí maximumFileSize
parametrů nebo maximumNumberOfFiles
v konstruktoruEventSchemaTraceListener.MaximumNumberOfFiles maximumFileSize
Pokud atributy nebo maximumNumberOfFiles
v konfiguračním souboru určují hodnotu mimo rozsah, vlastnosti se nastaví na výchozí hodnoty. Pokud zadáte hodnotu mimo rozsah v parametru maximumFileSize
nebo maximumNumberOfFiles
při volání konstruktoru EventSchemaTraceListenerArgumentOutOfRangeException , je vyvolána hodnota .
Následující tabulka uvádí možné a výchozí hodnoty velikosti souboru a počtu souborů, které jsou přidružené k jednotlivým možnostem uchovávání protokolu trasování. "N/A" znamená, že přidružená vlastnost není pro danou TraceLogRetentionOption hodnotu kontrolována.
TraceLogRetentionOption | Maximální velikost souboru | Výchozí velikost souboru | Maximální počet souborů | Výchozí počet souborů |
---|---|---|---|---|
LimitedCircularFiles | – | -1 | Nelze použít | 1 |
LimitedSequentialFiles | >0 | 4 kB | Nelze použít | 1 |
SingleFileBoundedSize | >0 | 4 kB | – | -1 |
SingleFileUnboundedSize | >0 | 4 kB | >0 | 1 |
UnlimitedSequentialFiles | >0 | 4 kB | >1 | 2 |