assemblies/DosInstallDependencies/Serilog.Sinks.File.xml
|
<?xml version="1.0"?>
<doc> <assembly> <name>Serilog.Sinks.File</name> </assembly> <members> <member name="T:Serilog.FileLoggerConfigurationExtensions"> <summary>Extends <see cref="T:Serilog.LoggerConfiguration"/> with methods to add file sinks.</summary> </member> <member name="M:Serilog.FileLoggerConfigurationExtensions.File(Serilog.Configuration.LoggerSinkConfiguration,System.String,Serilog.Events.LogEventLevel,System.String,System.IFormatProvider,System.Nullable{System.Int64},Serilog.Core.LoggingLevelSwitch,System.Boolean,System.Boolean,System.Nullable{System.TimeSpan})"> <summary> Write log events to the specified file. </summary> <param name="sinkConfiguration">Logger sink configuration.</param> <param name="path">Path to the file.</param> <param name="restrictedToMinimumLevel">The minimum level for events passed through the sink. Ignored when <paramref name="levelSwitch"/> is specified.</param> <param name="levelSwitch">A switch allowing the pass-through minimum level to be changed at runtime.</param> <param name="formatProvider">Supplies culture-specific formatting information, or null.</param> <param name="outputTemplate">A message template describing the format used to write to the sink. the default is "{Timestamp:yyyy-MM-dd HH:mm:ss.fff zzz} [{Level:u3}] {Message:lj}{NewLine}{Exception}".</param> <param name="fileSizeLimitBytes">The approximate maximum size, in bytes, to which a log file will be allowed to grow. For unrestricted growth, pass null. The default is 1 GB. To avoid writing partial events, the last event within the limit will be written in full even if it exceeds the limit.</param> <param name="buffered">Indicates if flushing to the output file can be buffered or not. The default is false.</param> <param name="shared">Allow the log file to be shared by multiple processes. The default is false.</param> <param name="flushToDiskInterval">If provided, a full disk flush will be performed periodically at the specified interval.</param> <returns>Configuration object allowing method chaining.</returns> <remarks>The file will be written using the UTF-8 character set.</remarks> </member> <member name="M:Serilog.FileLoggerConfigurationExtensions.File(Serilog.Configuration.LoggerSinkConfiguration,Serilog.Formatting.ITextFormatter,System.String,Serilog.Events.LogEventLevel,System.Nullable{System.Int64},Serilog.Core.LoggingLevelSwitch,System.Boolean,System.Boolean,System.Nullable{System.TimeSpan})"> <summary> Write log events to the specified file. </summary> <param name="sinkConfiguration">Logger sink configuration.</param> <param name="formatter">A formatter, such as <see cref="T:Serilog.Formatting.Json.JsonFormatter"/>, to convert the log events into text for the file. If control of regular text formatting is required, use the other overload of <see cref="M:Serilog.FileLoggerConfigurationExtensions.File(Serilog.Configuration.LoggerSinkConfiguration,System.String,Serilog.Events.LogEventLevel,System.String,System.IFormatProvider,System.Nullable{System.Int64},Serilog.Core.LoggingLevelSwitch,System.Boolean,System.Boolean,System.Nullable{System.TimeSpan})"/> and specify the outputTemplate parameter instead. </param> <param name="path">Path to the file.</param> <param name="restrictedToMinimumLevel">The minimum level for events passed through the sink. Ignored when <paramref name="levelSwitch"/> is specified.</param> <param name="levelSwitch">A switch allowing the pass-through minimum level to be changed at runtime.</param> <param name="fileSizeLimitBytes">The approximate maximum size, in bytes, to which a log file will be allowed to grow. For unrestricted growth, pass null. The default is 1 GB. To avoid writing partial events, the last event within the limit will be written in full even if it exceeds the limit.</param> <param name="buffered">Indicates if flushing to the output file can be buffered or not. The default is false.</param> <param name="shared">Allow the log file to be shared by multiple processes. The default is false.</param> <param name="flushToDiskInterval">If provided, a full disk flush will be performed periodically at the specified interval.</param> <returns>Configuration object allowing method chaining.</returns> <remarks>The file will be written using the UTF-8 character set.</remarks> </member> <member name="M:Serilog.FileLoggerConfigurationExtensions.File(Serilog.Configuration.LoggerSinkConfiguration,System.String,Serilog.Events.LogEventLevel,System.String,System.IFormatProvider,System.Nullable{System.Int64},Serilog.Core.LoggingLevelSwitch,System.Boolean,System.Boolean,System.Nullable{System.TimeSpan},Serilog.RollingInterval,System.Boolean,System.Nullable{System.Int32},System.Text.Encoding)"> <summary> Write log events to the specified file. </summary> <param name="sinkConfiguration">Logger sink configuration.</param> <param name="path">Path to the file.</param> <param name="restrictedToMinimumLevel">The minimum level for events passed through the sink. Ignored when <paramref name="levelSwitch"/> is specified.</param> <param name="levelSwitch">A switch allowing the pass-through minimum level to be changed at runtime.</param> <param name="formatProvider">Supplies culture-specific formatting information, or null.</param> <param name="outputTemplate">A message template describing the format used to write to the sink. the default is "{Timestamp:yyyy-MM-dd HH:mm:ss.fff zzz} [{Level:u3}] {Message:lj}{NewLine}{Exception}".</param> <param name="fileSizeLimitBytes">The approximate maximum size, in bytes, to which a log file will be allowed to grow. For unrestricted growth, pass null. The default is 1 GB. To avoid writing partial events, the last event within the limit will be written in full even if it exceeds the limit.</param> <param name="buffered">Indicates if flushing to the output file can be buffered or not. The default is false.</param> <param name="shared">Allow the log file to be shared by multiple processes. The default is false.</param> <param name="flushToDiskInterval">If provided, a full disk flush will be performed periodically at the specified interval.</param> <param name="rollingInterval">The interval at which logging will roll over to a new file.</param> <param name="rollOnFileSizeLimit">If <code>true</code>, a new file will be created when the file size limit is reached. Filenames will have a number appended in the format <code>_NNN</code>, with the first filename given no number.</param> <param name="retainedFileCountLimit">The maximum number of log files that will be retained, including the current log file. For unlimited retention, pass null. The default is 31.</param> <param name="encoding">Character encoding used to write the text file. The default is UTF-8 without BOM.</param> <returns>Configuration object allowing method chaining.</returns> <remarks>The file will be written using the UTF-8 character set.</remarks> </member> <member name="M:Serilog.FileLoggerConfigurationExtensions.File(Serilog.Configuration.LoggerSinkConfiguration,Serilog.Formatting.ITextFormatter,System.String,Serilog.Events.LogEventLevel,System.Nullable{System.Int64},Serilog.Core.LoggingLevelSwitch,System.Boolean,System.Boolean,System.Nullable{System.TimeSpan},Serilog.RollingInterval,System.Boolean,System.Nullable{System.Int32},System.Text.Encoding)"> <summary> Write log events to the specified file. </summary> <param name="sinkConfiguration">Logger sink configuration.</param> <param name="formatter">A formatter, such as <see cref="T:Serilog.Formatting.Json.JsonFormatter"/>, to convert the log events into text for the file. If control of regular text formatting is required, use the other overload of <see cref="M:Serilog.FileLoggerConfigurationExtensions.File(Serilog.Configuration.LoggerSinkConfiguration,System.String,Serilog.Events.LogEventLevel,System.String,System.IFormatProvider,System.Nullable{System.Int64},Serilog.Core.LoggingLevelSwitch,System.Boolean,System.Boolean,System.Nullable{System.TimeSpan},Serilog.RollingInterval,System.Boolean,System.Nullable{System.Int32},System.Text.Encoding)"/> and specify the outputTemplate parameter instead. </param> <param name="path">Path to the file.</param> <param name="restrictedToMinimumLevel">The minimum level for events passed through the sink. Ignored when <paramref name="levelSwitch"/> is specified.</param> <param name="levelSwitch">A switch allowing the pass-through minimum level to be changed at runtime.</param> <param name="fileSizeLimitBytes">The approximate maximum size, in bytes, to which a log file will be allowed to grow. For unrestricted growth, pass null. The default is 1 GB. To avoid writing partial events, the last event within the limit will be written in full even if it exceeds the limit.</param> <param name="buffered">Indicates if flushing to the output file can be buffered or not. The default is false.</param> <param name="shared">Allow the log file to be shared by multiple processes. The default is false.</param> <param name="flushToDiskInterval">If provided, a full disk flush will be performed periodically at the specified interval.</param> <param name="rollingInterval">The interval at which logging will roll over to a new file.</param> <param name="rollOnFileSizeLimit">If <code>true</code>, a new file will be created when the file size limit is reached. Filenames will have a number appended in the format <code>_NNN</code>, with the first filename given no number.</param> <param name="retainedFileCountLimit">The maximum number of log files that will be retained, including the current log file. For unlimited retention, pass null. The default is 31.</param> <param name="encoding">Character encoding used to write the text file. The default is UTF-8 without BOM.</param> <returns>Configuration object allowing method chaining.</returns> <remarks>The file will be written using the UTF-8 character set.</remarks> </member> <member name="M:Serilog.FileLoggerConfigurationExtensions.File(Serilog.Configuration.LoggerAuditSinkConfiguration,System.String,Serilog.Events.LogEventLevel,System.String,System.IFormatProvider,Serilog.Core.LoggingLevelSwitch)"> <summary> Write log events to the specified file. </summary> <param name="sinkConfiguration">Logger sink configuration.</param> <param name="path">Path to the file.</param> <param name="restrictedToMinimumLevel">The minimum level for events passed through the sink. Ignored when <paramref name="levelSwitch"/> is specified.</param> <param name="levelSwitch">A switch allowing the pass-through minimum level to be changed at runtime.</param> <param name="formatProvider">Supplies culture-specific formatting information, or null.</param> <param name="outputTemplate">A message template describing the format used to write to the sink. the default is "{Timestamp:yyyy-MM-dd HH:mm:ss.fff zzz} [{Level:u3}] {Message:lj}{NewLine}{Exception}".</param> <returns>Configuration object allowing method chaining.</returns> <remarks>The file will be written using the UTF-8 character set.</remarks> </member> <member name="M:Serilog.FileLoggerConfigurationExtensions.File(Serilog.Configuration.LoggerAuditSinkConfiguration,Serilog.Formatting.ITextFormatter,System.String,Serilog.Events.LogEventLevel,Serilog.Core.LoggingLevelSwitch)"> <summary> Write log events to the specified file. </summary> <param name="sinkConfiguration">Logger sink configuration.</param> <param name="formatter">A formatter, such as <see cref="T:Serilog.Formatting.Json.JsonFormatter"/>, to convert the log events into text for the file. If control of regular text formatting is required, use the other overload of <see cref="M:Serilog.FileLoggerConfigurationExtensions.File(Serilog.Configuration.LoggerAuditSinkConfiguration,System.String,Serilog.Events.LogEventLevel,System.String,System.IFormatProvider,Serilog.Core.LoggingLevelSwitch)"/> and specify the outputTemplate parameter instead. </param> <param name="path">Path to the file.</param> <param name="restrictedToMinimumLevel">The minimum level for events passed through the sink. Ignored when <paramref name="levelSwitch"/> is specified.</param> <param name="levelSwitch">A switch allowing the pass-through minimum level to be changed at runtime.</param> <returns>Configuration object allowing method chaining.</returns> <remarks>The file will be written using the UTF-8 character set.</remarks> </member> <member name="T:Serilog.RollingInterval"> <summary> Specifies the frequency at which the log file should roll. </summary> </member> <member name="F:Serilog.RollingInterval.Infinite"> <summary> The log file will never roll; no time period information will be appended to the log file name. </summary> </member> <member name="F:Serilog.RollingInterval.Year"> <summary> Roll every year. Filenames will have a four-digit year appended in the pattern <code>yyyy</code>. </summary> </member> <member name="F:Serilog.RollingInterval.Month"> <summary> Roll every calendar month. Filenames will have <code>yyyyMM</code> appended. </summary> </member> <member name="F:Serilog.RollingInterval.Day"> <summary> Roll every day. Filenames will have <code>yyyyMMdd</code> appended. </summary> </member> <member name="F:Serilog.RollingInterval.Hour"> <summary> Roll every hour. Filenames will have <code>yyyyMMddHH</code> appended. </summary> </member> <member name="F:Serilog.RollingInterval.Minute"> <summary> Roll every minute. Filenames will have <code>yyyyMMddHHmm</code> appended. </summary> </member> <member name="T:Serilog.Sinks.File.FileSink"> <summary> Write log events to a disk file. </summary> </member> <member name="M:Serilog.Sinks.File.FileSink.#ctor(System.String,Serilog.Formatting.ITextFormatter,System.Nullable{System.Int64},System.Text.Encoding,System.Boolean)"> <summary>Construct a <see cref="T:Serilog.Sinks.File.FileSink"/>.</summary> <param name="path">Path to the file.</param> <param name="textFormatter">Formatter used to convert log events to text.</param> <param name="fileSizeLimitBytes">The approximate maximum size, in bytes, to which a log file will be allowed to grow. For unrestricted growth, pass null. The default is 1 GB. To avoid writing partial events, the last event within the limit will be written in full even if it exceeds the limit.</param> <param name="encoding">Character encoding used to write the text file. The default is UTF-8 without BOM.</param> <param name="buffered">Indicates if flushing to the output file can be buffered or not. The default is false.</param> <returns>Configuration object allowing method chaining.</returns> <remarks>The file will be written using the UTF-8 character set.</remarks> <exception cref="T:System.IO.IOException"></exception> </member> <member name="M:Serilog.Sinks.File.FileSink.Emit(Serilog.Events.LogEvent)"> <summary> Emit the provided log event to the sink. </summary> <param name="logEvent">The log event to write.</param> </member> <member name="M:Serilog.Sinks.File.FileSink.Dispose"> <inheritdoc /> </member> <member name="M:Serilog.Sinks.File.FileSink.FlushToDisk"> <inheritdoc /> </member> <member name="T:Serilog.Sinks.File.IFileSink"> <summary> Exists only for the convenience of <see cref="T:Serilog.Sinks.File.RollingFileSink"/>, which switches implementations based on sharing. Would refactor, but preserving backwards compatibility. </summary> </member> <member name="T:Serilog.Sinks.File.IFlushableFileSink"> <summary> Supported by (file-based) sinks that can be explicitly flushed. </summary> </member> <member name="M:Serilog.Sinks.File.IFlushableFileSink.FlushToDisk"> <summary> Flush buffered contents to disk. </summary> </member> <member name="T:Serilog.Sinks.File.NullSink"> <summary> An instance of this sink may be substituted when an instance of the <see cref="T:Serilog.Sinks.File.FileSink"/> is unable to be constructed. </summary> </member> <member name="T:Serilog.Sinks.File.PeriodicFlushToDiskSink"> <summary> A sink wrapper that periodically flushes the wrapped sink to disk. </summary> </member> <member name="M:Serilog.Sinks.File.PeriodicFlushToDiskSink.#ctor(Serilog.Core.ILogEventSink,System.TimeSpan)"> <summary> Construct a <see cref="T:Serilog.Sinks.File.PeriodicFlushToDiskSink"/> that wraps <paramref name="sink"/> and flushes it at the specified <paramref name="flushInterval"/>. </summary> <param name="sink">The sink to wrap.</param> <param name="flushInterval">The interval at which to flush the underlying sink.</param> <exception cref="T:System.ArgumentNullException"></exception> </member> <member name="M:Serilog.Sinks.File.PeriodicFlushToDiskSink.Emit(Serilog.Events.LogEvent)"> <inheritdoc /> </member> <member name="M:Serilog.Sinks.File.PeriodicFlushToDiskSink.Dispose"> <inheritdoc /> </member> <member name="T:Serilog.Sinks.File.SharedFileSink"> <summary> Write log events to a disk file. </summary> </member> <member name="M:Serilog.Sinks.File.SharedFileSink.#ctor(System.String,Serilog.Formatting.ITextFormatter,System.Nullable{System.Int64},System.Text.Encoding)"> <summary>Construct a <see cref="T:Serilog.Sinks.File.FileSink"/>.</summary> <param name="path">Path to the file.</param> <param name="textFormatter">Formatter used to convert log events to text.</param> <param name="fileSizeLimitBytes">The approximate maximum size, in bytes, to which a log file will be allowed to grow. For unrestricted growth, pass null. The default is 1 GB. To avoid writing partial events, the last event within the limit will be written in full even if it exceeds the limit.</param> <param name="encoding">Character encoding used to write the text file. The default is UTF-8 without BOM.</param> <returns>Configuration object allowing method chaining.</returns> <remarks>The file will be written using the UTF-8 character set.</remarks> <exception cref="T:System.IO.IOException"></exception> </member> <member name="M:Serilog.Sinks.File.SharedFileSink.Emit(Serilog.Events.LogEvent)"> <summary> Emit the provided log event to the sink. </summary> <param name="logEvent">The log event to write.</param> </member> <member name="M:Serilog.Sinks.File.SharedFileSink.Dispose"> <inheritdoc /> </member> <member name="M:Serilog.Sinks.File.SharedFileSink.FlushToDisk"> <inheritdoc /> </member> </members> </doc> |