FileTarget Class

Initializes a new instance of the FileTarget class.

Initializes a new instance of the FileTarget class.

Gets or sets the size in bytes above which log files will be automatically archived. Zero or negative means disabled.

Gets or sets a value indicating whether to trigger archive operation based on time-period, by moving active-file to file-path specified by ArchiveFileName

Legacy archive logic where file-archive-logic moves active file to path specified by ArchiveFileName, and then recreates the active file. Use ArchiveSuffixFormat to control suffix format, instead of now obsolete token {#}

Gets or sets a value indicating whether any existing log-file should be archived on startup.

Gets or sets the format-string to convert archive sequence-number by using string.Format

Gets or sets a value indicating whether to automatically flush the file buffers after each log message.

Gets or sets the log file buffer size in bytes.

Gets or sets a value indicating whether to create directories if they do not exist.

Gets or sets a value indicating whether to delete old log file on startup.

Gets or sets whether or not this target should just discard all data that its asked to write. Mostly used for when testing NLog Stack except final write

Gets or sets a value indicating whether to enable log file(s) to be deleted.

Gets or sets the file encoding.

Gets or sets the name of the file to write to.

Gets or sets the footer.

Gets or sets the header.

Gets a value indicating whether the target has been initialized.

Gets or sets a value indicating whether to keep log file open instead of opening and closing it on each logging event.

Gets or sets the layout used to format log messages.

Gets or sets the line ending mode.

Gets the logging configuration this target is part of.

Gets or sets the maximum days of archive files that should be kept. Zero or negative means disabled.

Gets or sets the maximum number of archive files that should be kept. Negative means disabled.

Gets or sets the name of the target.

Gets or sets the maximum number of files to be kept open.

Gets or sets the maximum number of seconds that files are kept open. Zero or negative means disabled.

Gets or sets the maximum number of seconds before open files are flushed. Zero or negative means disabled.

Gets or sets a value indicating whether to replace file contents on each write instead of appending log message at the end.

Gets the object which can be used to synchronize asynchronous operations that must rely on the .

Gets or sets a value indicating whether to write BOM (byte order mark) in created files.

Gets or sets a value indicating whether the footer should be written only when the file is archived.

Gets or sets whether to write the Header on initial creation of file appender, even if the file is not empty. Default value is , which means only write header when initial file is empty (Ex. ensures valid CSV files)

Calculate the DateTime of the requested day of the week.

Closes the target to release any initialized resources

Creates stream for appending to the specified filePath

Closes the target.

Releases unmanaged and - optionally - managed resources.

Flush any pending log messages (in case of asynchronous targets).

Flushes all pending file operations.

Initializes the target before writing starts

Calls the Precalculate(LogEventInfo) on each volatile layout used by this target. This method won't prerender if all layouts in this target are thread-agnostic.

Formats the log event for write.

Renders the logevent into a string-result using the provided layout

Renders the logevent into a result-value by using the provided layout

Resolve from DI ServiceRepository

Returns a string that represents the current object.

Writes async log event to the log target.

Writes an array of logging events to the log target. By default it iterates on all events and passes them to "Write" method. Inheriting classes can use this method to optimize batch writes.

Writes logging event to the target destination

Writes the log to the target.

Writes the array of log events.

Writes the array of log events.

Writes a log event to the log target, in a thread safe manner. Any override of this method has to provide their own synchronization mechanism. !WARNING! Custom targets should only override this method if able to provide their own synchronization mechanism. Layout-objects are not guaranteed to be thread-safe, so using them without a SyncRoot-object can be dangerous.

Writes an array of logging events to the log target, in a thread safe manner. Any override of this method has to provide their own synchronization mechanism. !WARNING! Custom targets should only override this method if able to provide their own synchronization mechanism. Layout-objects are not guaranteed to be thread-safe, so using them without a SyncRoot-object can be dangerous.

LogEvent is written to target, but target failed to successfully initialize