TraceLogRetentionOption Énumération

Définition

Spécifie la structure de fichiers utilisée pour le journal EventSchemaTraceListener.

public enum class TraceLogRetentionOption
public enum TraceLogRetentionOption
type TraceLogRetentionOption = 
Public Enum TraceLogRetentionOption
Héritage
TraceLogRetentionOption

Champs

LimitedCircularFiles 1

Nombre fini de fichiers à accès séquentiel, chacun avec une taille maximale de fichier. Lorsque la valeur de la propriété MaximumFileSize est atteinte, l'écriture commence dans un nouveau fichier par un suffixe entier incrémenté. Lorsque la valeur de la propriété MaximumNumberOfFiles est atteinte, le premier fichier est effacé et est remplacé. Les fichiers sont ensuite remplacés par incréments de façon circulaire.

LimitedSequentialFiles 3

Nombre fini de fichiers à accès séquentiel, chacun avec une taille maximale de fichier. Lorsque la valeur de la propriété MaximumFileSize est atteinte, l'écriture commence dans un nouveau fichier par un suffixe entier incrémenté.

SingleFileBoundedSize 4

Fichier avec une taille maximale de fichier déterminée par la propriété MaximumFileSize.

SingleFileUnboundedSize 2

Fichier sans restrictions sur la taille maximale de fichier.

UnlimitedSequentialFiles 0

Nombre illimité de fichiers à accès séquentiel, chacun avec une taille maximale de fichier déterminée par la propriété MaximumFileSize. Il n'y a aucune limite logique au nombre ou à la taille des fichiers, mais une limite existe en raison des contraintes physiques imposées par l'ordinateur.

Remarques

L’énumération TraceLogRetentionOption est utilisée pour spécifier la valeur de la TraceLogRetentionOption propriété dans la EventSchemaTraceListener classe . Ce paramètre de propriété détermine les valeurs possibles et par défaut pour les EventSchemaTraceListener.MaximumFileSize propriétés et .EventSchemaTraceListener.MaximumNumberOfFiles

Vous pouvez définir les MaximumFileSize propriétés et MaximumNumberOfFiles via les maximumFileSize attributs personnalisés et maximumNumberOfFiles dans le fichier de configuration ou à l’aide des maximumFileSize paramètres ou maximumNumberOfFiles dans le EventSchemaTraceListener constructeur. Si les maximumFileSize attributs ou maximumNumberOfFiles du fichier de configuration spécifient une valeur hors plage, les propriétés sont définies sur leurs valeurs par défaut. Si vous spécifiez une valeur hors plage dans le maximumFileSize paramètre ou maximumNumberOfFiles lorsque vous appelez le EventSchemaTraceListener constructeur, une ArgumentOutOfRangeException valeur est levée.

Le tableau suivant montre les valeurs possibles et par défaut pour la taille de fichier et le nombre de fichiers associés à chaque option de rétention du journal de trace. « N/A » indique que la propriété associée n’est pas vérifiée pour cette TraceLogRetentionOption valeur.

TraceLogRetentionOption Taille maximale du fichier Taille de fichier par défaut Nombre maximal de fichiers Nombre de fichiers par défaut
LimitedCircularFiles N/A -1 N/A 1
LimitedSequentialFiles >0 4 Ko N/A 1
SingleFileBoundedSize >0 4 Ko N/A -1
SingleFileUnboundedSize >0 4 Ko >0 1
UnlimitedSequentialFiles >0 4 Ko >1 2

S’applique à