TraceLogRetentionOption Enumeración
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Especifica la estructura de archivos que se utilizará para el registro de EventSchemaTraceListener.
public enum class TraceLogRetentionOption
public enum TraceLogRetentionOption
type TraceLogRetentionOption =
Public Enum TraceLogRetentionOption
- Herencia
Campos
LimitedCircularFiles | 1 | Número finito de archivos secuenciales, cada uno con un tamaño máximo de archivo. Cuando se alcanza el valor de la propiedad MaximumFileSize, la escritura comienza en un nuevo archivo con un sufijo entero incrementado. Cuando se alcanza el valor de la propiedad MaximumNumberOfFiles, se borra y sobrescribe el primer archivo. Los archivos se sobrescriben incrementalmente de manera circular. |
LimitedSequentialFiles | 3 | Número finito de archivos secuenciales, cada uno con un tamaño máximo de archivo. Cuando se alcanza el valor de la propiedad MaximumFileSize, la escritura comienza en un nuevo archivo con un sufijo entero incrementado. |
SingleFileBoundedSize | 4 | Archivo con un tamaño máximo determinado por la propiedad MaximumFileSize. |
SingleFileUnboundedSize | 2 | Archivo sin la restricción de tamaño máximo de archivo. |
UnlimitedSequentialFiles | 0 | Número ilimitado de archivos secuenciales, cada uno con un tamaño máximo de archivo determinado por la propiedad MaximumFileSize. No hay ningún límite lógico al número o tamaño de los archivos, pero está limitado por las restricciones físicas impuestas por el equipo. |
Comentarios
La TraceLogRetentionOption enumeración se usa para especificar el valor de la TraceLogRetentionOption propiedad en la EventSchemaTraceListener clase . Ese valor de propiedad determina los valores posibles y predeterminados de las EventSchemaTraceListener.MaximumFileSize propiedades y EventSchemaTraceListener.MaximumNumberOfFiles .
Puede establecer las MaximumFileSize propiedades y a través de los maximumFileSize
atributos y maximumNumberOfFiles
MaximumNumberOfFiles personalizados en el archivo de configuración o mediante los maximumFileSize
parámetros o maximumNumberOfFiles
en el EventSchemaTraceListener constructor. Si los maximumFileSize
atributos o maximumNumberOfFiles
del archivo de configuración especifican un valor fuera del intervalo, las propiedades se establecen en sus valores predeterminados. Si especifica un valor fuera del intervalo en el maximumFileSize
parámetro o maximumNumberOfFiles
al llamar al EventSchemaTraceListener constructor , se produce una ArgumentOutOfRangeException excepción .
En la tabla siguiente se muestran los valores posibles y predeterminados para el tamaño de archivo y el recuento de archivos asociados a cada opción de retención del registro de seguimiento. "N/A" indica que la propiedad asociada no está activada para ese TraceLogRetentionOption valor.
TraceLogRetentionOption | Tamaño de archivo máximo | Tamaño de archivo predeterminado | Número máximo de archivos | Número predeterminado de archivos |
---|---|---|---|---|
LimitedCircularFiles | N/D | -1 | N/D | 1 |
LimitedSequentialFiles | >0 | 4 kB | N/D | 1 |
SingleFileBoundedSize | >0 | 4 kB | N/D | -1 |
SingleFileUnboundedSize | >0 | 4 kB | >0 | 1 |
UnlimitedSequentialFiles | >0 | 4 kB | >1 | 2 |