add nugets
This commit is contained in:
master
518
.nuget/packages/serilog.sinks.file/5.0.0/lib/net45/Serilog.Sinks.File.xml
vendored
Normal file
518
.nuget/packages/serilog.sinks.file/5.0.0/lib/net45/Serilog.Sinks.File.xml
vendored
Normal file
@@ -0,0 +1,518 @@
|
||||
<?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>
|
||||
</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,Serilog.Sinks.File.FileLifecycleHooks,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>
|
||||
<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>
|
||||
</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,Serilog.Sinks.File.FileLifecycleHooks,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>
|
||||
<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>
|
||||
<param name="hooks">Optionally enables hooking into log file lifecycle events.</param>
|
||||
<param name="retainedFileTimeLimit">The maximum time after the end of an interval that a rolling log file will be retained.
|
||||
Must be greater than or equal to <see cref="F:System.TimeSpan.Zero"/>.
|
||||
Ignored if <paramref see="rollingInterval"/> is <see cref="F:Serilog.RollingInterval.Infinite"/>.
|
||||
The default is to retain files indefinitely.</param>
|
||||
<returns>Configuration object allowing method chaining.</returns>
|
||||
<exception cref="T:System.ArgumentNullException">When <paramref name="sinkConfiguration"/> is <code>null</code></exception>
|
||||
<exception cref="T:System.ArgumentNullException">When <paramref name="path"/> is <code>null</code></exception>
|
||||
<exception cref="T:System.ArgumentNullException">When <paramref name="outputTemplate"/> is <code>null</code></exception>
|
||||
<exception cref="T:System.IO.IOException"></exception>
|
||||
<exception cref="T:System.InvalidOperationException"></exception>
|
||||
<exception cref="T:System.NotSupportedException"></exception>
|
||||
<exception cref="T:System.IO.PathTooLongException">When <paramref name="path"/> is too long</exception>
|
||||
<exception cref="T:System.UnauthorizedAccessException">The caller does not have the required permission to access the <paramref name="path"/></exception>
|
||||
<exception cref="T:System.ArgumentException">Invalid <paramref name="path"/></exception>
|
||||
</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,Serilog.Sinks.File.FileLifecycleHooks,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},Serilog.RollingInterval,System.Boolean,System.Nullable{System.Int32},System.Text.Encoding,Serilog.Sinks.File.FileLifecycleHooks,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>
|
||||
<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>
|
||||
<param name="hooks">Optionally enables hooking into log file lifecycle events.</param>
|
||||
<param name="retainedFileTimeLimit">The maximum time after the end of an interval that a rolling log file will be retained.
|
||||
Must be greater than or equal to <see cref="F:System.TimeSpan.Zero"/>.
|
||||
Ignored if <paramref see="rollingInterval"/> is <see cref="F:Serilog.RollingInterval.Infinite"/>.
|
||||
The default is to retain files indefinitely.</param>
|
||||
<returns>Configuration object allowing method chaining.</returns>
|
||||
<exception cref="T:System.ArgumentNullException">When <paramref name="sinkConfiguration"/> is <code>null</code></exception>
|
||||
<exception cref="T:System.ArgumentNullException">When <paramref name="formatter"/> is <code>null</code></exception>
|
||||
<exception cref="T:System.ArgumentNullException">When <paramref name="path"/> is <code>null</code></exception>
|
||||
<exception cref="T:System.IO.IOException"></exception>
|
||||
<exception cref="T:System.InvalidOperationException"></exception>
|
||||
<exception cref="T:System.NotSupportedException"></exception>
|
||||
<exception cref="T:System.IO.PathTooLongException">When <paramref name="path"/> is too long</exception>
|
||||
<exception cref="T:System.UnauthorizedAccessException">The caller does not have the required permission to access the <paramref name="path"/></exception>
|
||||
<exception cref="T:System.ArgumentException">Invalid <paramref name="path"/></exception>
|
||||
</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>
|
||||
<exception cref="T:System.ArgumentNullException">When <paramref name="sinkConfiguration"/> is <code>null</code></exception>
|
||||
<exception cref="T:System.ArgumentNullException">When <paramref name="path"/> is <code>null</code></exception>
|
||||
<exception cref="T:System.IO.IOException"></exception>
|
||||
<exception cref="T:System.InvalidOperationException"></exception>
|
||||
<exception cref="T:System.NotSupportedException"></exception>
|
||||
<exception cref="T:System.IO.PathTooLongException">When <paramref name="path"/> is too long</exception>
|
||||
<exception cref="T:System.UnauthorizedAccessException">The caller does not have the required permission to access the <paramref name="path"/></exception>
|
||||
<exception cref="T:System.ArgumentException">Invalid <paramref name="path"/></exception>
|
||||
</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>
|
||||
<exception cref="T:System.ArgumentNullException">When <paramref name="sinkConfiguration"/> is <code>null</code></exception>
|
||||
<exception cref="T:System.ArgumentNullException">When <paramref name="formatter"/> is <code>null</code></exception>
|
||||
<exception cref="T:System.ArgumentNullException">When <paramref name="path"/> is <code>null</code></exception>
|
||||
<exception cref="T:System.IO.IOException"></exception>
|
||||
<exception cref="T:System.InvalidOperationException"></exception>
|
||||
<exception cref="T:System.NotSupportedException"></exception>
|
||||
<exception cref="T:System.IO.PathTooLongException">When <paramref name="path"/> is too long</exception>
|
||||
<exception cref="T:System.UnauthorizedAccessException">The caller does not have the required permission to access the <paramref name="path"/></exception>
|
||||
<exception cref="T:System.ArgumentException">Invalid <paramref name="path"/></exception>
|
||||
</member>
|
||||
<member name="M:Serilog.FileLoggerConfigurationExtensions.File(Serilog.Configuration.LoggerAuditSinkConfiguration,System.String,Serilog.Events.LogEventLevel,System.String,System.IFormatProvider,Serilog.Core.LoggingLevelSwitch,System.Text.Encoding,Serilog.Sinks.File.FileLifecycleHooks)">
|
||||
<summary>
|
||||
Write audit 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="encoding">Character encoding used to write the text file. The default is UTF-8 without BOM.</param>
|
||||
<param name="hooks">Optionally enables hooking into log file lifecycle events.</param>
|
||||
<returns>Configuration object allowing method chaining.</returns>
|
||||
<exception cref="T:System.ArgumentNullException">When <paramref name="sinkConfiguration"/> is <code>null</code></exception>
|
||||
<exception cref="T:System.ArgumentNullException">When <paramref name="path"/> is <code>null</code></exception>
|
||||
<exception cref="T:System.ArgumentNullException">When <paramref name="outputTemplate"/> is <code>null</code></exception>
|
||||
<exception cref="T:System.IO.IOException"></exception>
|
||||
<exception cref="T:System.InvalidOperationException"></exception>
|
||||
<exception cref="T:System.NotSupportedException"></exception>
|
||||
<exception cref="T:System.IO.PathTooLongException">When <paramref name="path"/> is too long</exception>
|
||||
<exception cref="T:System.UnauthorizedAccessException">The caller does not have the required permission to access the <paramref name="path"/></exception>
|
||||
<exception cref="T:System.ArgumentException">Invalid <paramref name="path"/></exception>
|
||||
</member>
|
||||
<member name="M:Serilog.FileLoggerConfigurationExtensions.File(Serilog.Configuration.LoggerAuditSinkConfiguration,Serilog.Formatting.ITextFormatter,System.String,Serilog.Events.LogEventLevel,Serilog.Core.LoggingLevelSwitch,System.Text.Encoding,Serilog.Sinks.File.FileLifecycleHooks)">
|
||||
<summary>
|
||||
Write audit 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,System.Text.Encoding,Serilog.Sinks.File.FileLifecycleHooks)"/>
|
||||
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="encoding">Character encoding used to write the text file. The default is UTF-8 without BOM.</param>
|
||||
<param name="hooks">Optionally enables hooking into log file lifecycle events.</param>
|
||||
<returns>Configuration object allowing method chaining.</returns>
|
||||
<exception cref="T:System.ArgumentNullException">When <paramref name="sinkConfiguration"/> is <code>null</code></exception>
|
||||
<exception cref="T:System.ArgumentNullException">When <paramref name="formatter"/> is <code>null</code></exception>
|
||||
<exception cref="T:System.ArgumentNullException">When <paramref name="path"/> is <code>null</code></exception>
|
||||
<exception cref="T:System.IO.IOException"></exception>
|
||||
<exception cref="T:System.InvalidOperationException"></exception>
|
||||
<exception cref="T:System.NotSupportedException"></exception>
|
||||
<exception cref="T:System.IO.PathTooLongException">When <paramref name="path"/> is too long</exception>
|
||||
<exception cref="T:System.UnauthorizedAccessException">The caller does not have the required permission to access the <paramref name="path"/></exception>
|
||||
<exception cref="T:System.ArgumentException">Invalid <paramref name="path"/></exception>
|
||||
</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.FileLifecycleHooks">
|
||||
<summary>
|
||||
Enables hooking into log file lifecycle events.
|
||||
Hooks run synchronously and therefore may affect responsiveness of the application if long operations are performed.
|
||||
</summary>
|
||||
</member>
|
||||
<member name="M:Serilog.Sinks.File.FileLifecycleHooks.OnFileOpened(System.String,System.IO.Stream,System.Text.Encoding)">
|
||||
<summary>
|
||||
Initialize or wrap the <paramref name="underlyingStream"/> opened on the log file. This can be used to write
|
||||
file headers, or wrap the stream in another that adds buffering, compression, encryption, etc. The underlying
|
||||
file may or may not be empty when this method is called.
|
||||
</summary>
|
||||
<remarks>
|
||||
A value must be returned from overrides of this method. Serilog will flush and/or dispose the returned value, but will not
|
||||
dispose the stream initially passed in unless it is itself returned.
|
||||
</remarks>
|
||||
<param name="path">The full path to the log file.</param>
|
||||
<param name="underlyingStream">The underlying <see cref="T:System.IO.Stream"/> opened on the log file.</param>
|
||||
<param name="encoding">The encoding to use when reading/writing to the stream.</param>
|
||||
<returns>The <see cref="T:System.IO.Stream"/> Serilog should use when writing events to the log file.</returns>
|
||||
</member>
|
||||
<member name="M:Serilog.Sinks.File.FileLifecycleHooks.OnFileOpened(System.IO.Stream,System.Text.Encoding)">
|
||||
<summary>
|
||||
Initialize or wrap the <paramref name="underlyingStream"/> opened on the log file. This can be used to write
|
||||
file headers, or wrap the stream in another that adds buffering, compression, encryption, etc. The underlying
|
||||
file may or may not be empty when this method is called.
|
||||
</summary>
|
||||
<remarks>
|
||||
A value must be returned from overrides of this method. Serilog will flush and/or dispose the returned value, but will not
|
||||
dispose the stream initially passed in unless it is itself returned.
|
||||
</remarks>
|
||||
<param name="underlyingStream">The underlying <see cref="T:System.IO.Stream"/> opened on the log file.</param>
|
||||
<param name="encoding">The encoding to use when reading/writing to the stream.</param>
|
||||
<returns>The <see cref="T:System.IO.Stream"/> Serilog should use when writing events to the log file.</returns>
|
||||
</member>
|
||||
<member name="M:Serilog.Sinks.File.FileLifecycleHooks.OnFileDeleting(System.String)">
|
||||
<summary>
|
||||
Called before an obsolete (rolling) log file is deleted.
|
||||
This can be used to copy old logs to an archive location or send to a backup server.
|
||||
</summary>
|
||||
<param name="path">The full path to the file being deleted.</param>
|
||||
</member>
|
||||
<member name="M:Serilog.Sinks.File.FileLifecycleHooks.Then(Serilog.Sinks.File.FileLifecycleHooks)">
|
||||
<summary>
|
||||
Creates a chain of <see cref="T:Serilog.Sinks.File.FileLifecycleHooks"/> that have their methods called sequentially
|
||||
Can be used to compose <see cref="T:Serilog.Sinks.File.FileLifecycleHooks"/> together; e.g. add header information to each log file and
|
||||
compress it.
|
||||
</summary>
|
||||
<example>
|
||||
<code>
|
||||
var hooks = new GZipHooks().Then(new HeaderWriter("File Header"));
|
||||
</code>
|
||||
</example>
|
||||
<param name="next">The next <see cref="T:Serilog.Sinks.File.FileLifecycleHooks"/> to have its methods called in the chain</param>
|
||||
<returns></returns>
|
||||
</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>This constructor preserves compatibility with early versions of the public API. New code should not depend on this type.</remarks>
|
||||
<exception cref="T:System.ArgumentNullException">When <paramref name="textFormatter"/> is <code>null</code></exception>
|
||||
<exception cref="T:System.ArgumentException">When <paramref name="fileSizeLimitBytes"/> is <code>null</code> or less than <code>0</code></exception>
|
||||
<exception cref="T:System.ArgumentNullException">When <paramref name="path"/> is <code>null</code></exception>
|
||||
<exception cref="T:System.IO.IOException"></exception>
|
||||
<exception cref="T:System.InvalidOperationException"></exception>
|
||||
<exception cref="T:System.NotSupportedException"></exception>
|
||||
<exception cref="T:System.IO.PathTooLongException">When <paramref name="path"/> is too long</exception>
|
||||
<exception cref="T:System.UnauthorizedAccessException">The caller does not have the required permission to access the <paramref name="path"/></exception>
|
||||
<exception cref="T:System.ArgumentException">Invalid <paramref name="path"/></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>
|
||||
<exception cref="T:System.ArgumentNullException">When <paramref name="logEvent"/> is <code>null</code></exception>
|
||||
</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">When <paramref name="sink"/> is <code>null</code></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>
|
||||
<exception cref="T:System.ArgumentNullException">When <paramref name="path"/> is <code>null</code></exception>
|
||||
<exception cref="T:System.ArgumentNullException">When <paramref name="textFormatter"/> is <code>null</code></exception>
|
||||
<exception cref="T:System.IO.IOException"></exception>
|
||||
<exception cref="T:System.InvalidOperationException"></exception>
|
||||
<exception cref="T:System.NotSupportedException"></exception>
|
||||
<exception cref="T:System.IO.PathTooLongException">When <paramref name="path"/> is too long</exception>
|
||||
<exception cref="T:System.UnauthorizedAccessException">The caller does not have the required permission to access the <paramref name="path"/></exception>
|
||||
<exception cref="T:System.ArgumentException">Invalid <paramref name="path"/></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>
|
||||
<exception cref="T:System.ArgumentNullException">When <paramref name="logEvent"/> is <code>null</code></exception>
|
||||
</member>
|
||||
<member name="M:Serilog.Sinks.File.SharedFileSink.Dispose">
|
||||
<inheritdoc />
|
||||
</member>
|
||||
<member name="M:Serilog.Sinks.File.SharedFileSink.FlushToDisk">
|
||||
<inheritdoc />
|
||||
</member>
|
||||
</members>
|
||||
</doc>
|
||||
Reference in New Issue
Block a user