NLog by Jarek Kowalski,Kim Christensen,Julian Verdurmen

<PackageReference Include="NLog" Version="4.7.13" />

---

API Diff between 4.7.13 and 5.1.5

141 Additions 180 Removals

NLog

• public static class GDC
  • public static void Clear()
  • public static bool Contains(string item)
  • public static string Get(string item)
  • public static string Get(string item, IFormatProvider formatProvider)
  • public static object GetObject(string item)
  • public static void Remove(string item)
  • public static void Set(string item, string value)
• public static class ILoggerExtensions
  • public static void ConditionalDebug<T>(this ILogger logger, T value)
  • public static void ConditionalDebug<T>(this ILogger logger, IFormatProvider formatProvider, T value)
  • public static void ConditionalDebug(this ILogger logger, LogMessageGenerator messageFunc)
  • public static void ConditionalDebug(this ILogger logger, Exception exception, string message, object[] args)
  • public static void ConditionalDebug(this ILogger logger, Exception exception, IFormatProvider formatProvider, string message, object[] args)
  • public static void ConditionalDebug(this ILogger logger, string message)
  • public static void ConditionalDebug(this ILogger logger, string message, object[] args)
  • public static void ConditionalDebug(this ILogger logger, IFormatProvider formatProvider, string message, object[] args)
  • public static void ConditionalDebug<TArgument>(this ILogger logger, string message, TArgument argument)
  • public static void ConditionalDebug<TArgument1, TArgument2>(this ILogger logger, string message, TArgument1 argument1, TArgument2 argument2)
  • public static void ConditionalDebug<TArgument1, TArgument2, TArgument3>(this ILogger logger, string message, TArgument1 argument1, TArgument2 argument2, TArgument3 argument3)
  • public static void ConditionalTrace<T>(this ILogger logger, T value)
  • public static void ConditionalTrace<T>(this ILogger logger, IFormatProvider formatProvider, T value)
  • public static void ConditionalTrace(this ILogger logger, LogMessageGenerator messageFunc)
  • public static void ConditionalTrace(this ILogger logger, Exception exception, string message, object[] args)
  • public static void ConditionalTrace(this ILogger logger, Exception exception, IFormatProvider formatProvider, string message, object[] args)
  • public static void ConditionalTrace(this ILogger logger, string message)
  • public static void ConditionalTrace(this ILogger logger, string message, object[] args)
  • public static void ConditionalTrace(this ILogger logger, IFormatProvider formatProvider, string message, object[] args)
  • public static void ConditionalTrace<TArgument>(this ILogger logger, string message, TArgument argument)
  • public static void ConditionalTrace<TArgument1, TArgument2>(this ILogger logger, string message, TArgument1 argument1, TArgument2 argument2)
  • public static void ConditionalTrace<TArgument1, TArgument2, TArgument3>(this ILogger logger, string message, TArgument1 argument1, TArgument2 argument2, TArgument3 argument3)
  • public static LogEventBuilder ForDebugEvent(this ILogger logger)
  • public static LogEventBuilder ForErrorEvent(this ILogger logger)
  • public static LogEventBuilder ForExceptionEvent(this ILogger logger, Exception exception, LogLevel logLevel = null)
  • public static LogEventBuilder ForFatalEvent(this ILogger logger)
  • public static LogEventBuilder ForInfoEvent(this ILogger logger)
  • public static LogEventBuilder ForLogEvent(this ILogger logger, LogLevel logLevel = null)
  • public static LogEventBuilder ForTraceEvent(this ILogger logger)
  • public static LogEventBuilder ForWarnEvent(this ILogger logger)
• public static class LayoutTypedExtensions
• public struct LogEventBuilder
• public class LogEventInfo
  • public IDictionary Context { get; }
  • public string LoggerShortName { get; }
  • public static LogEventInfo Create(LogLevel logLevel, string loggerName, string message, Exception exception)
• public class LogFactory : IDisposable
  • public ServiceRepository ServiceRepository { get; }
  • public IDisposable DisableLogging()
  • public void EnableLogging()
  • public void ReconfigExistingLoggers(bool purgeObsoleteLoggers)
• public class Logger : ILogger, ILoggerBase, ISuppress
  • public void Debug(string message, Exception exception)
  • public void Error(string message, Exception exception)
  • public void Fatal(string message, Exception exception)
  • public void Info(string message, Exception exception)
  • public void Log(LogLevel level, string message, Exception exception)
  • public void LogException(LogLevel level, string message, Exception exception)
  • public IDisposable PushScopeNested<T>(T nestedState)
  • public IDisposable PushScopeNested(object nestedState)
  • public IDisposable PushScopeProperties(IReadOnlyCollection<KeyValuePair<string, object>> scopeProperties)
  • public IDisposable PushScopeProperties<TValue>(IReadOnlyCollection<KeyValuePair<string, TValue>> scopeProperties)
  • public IDisposable PushScopeProperty(string propertyName, object propertyValue)
  • public IDisposable PushScopeProperty<TValue>(string propertyName, TValue propertyValue)
  • public void Trace(string message, Exception exception)
  • public void Warn(string message, Exception exception)
  • public Logger WithProperties(IEnumerable<KeyValuePair<string, object>> properties)
• public sealed class LogLevel : IComparable, IEquatable<LogLevel>, IConvertible
  • public int CompareTo(LogLevel other)
• public static class LogManager
  • public sealed delegate GetCultureInfo : MulticastDelegate
  • public static GetCultureInfo DefaultCultureInfo { get; set; }
  • public static void ReconfigExistingLoggers(bool purgeObsoleteLoggers)
  • public static void ResumeLogging()
  • public static IDisposable SuspendLogging()
• public static class MDC
  • public static void Clear()
  • public static bool Contains(string item)
  • public static string Get(string item)
  • public static object GetObject(string item)
  • public static void Remove(string item)
  • public static void Set(string item, string value)
• public static class NDC
  • public static string TopMessage { get; }
  • public static object TopObject { get; }
  • public static void Clear()
  • public static string[] GetAllMessages()
  • public static object[] GetAllObjects()
  • public static string Pop()
  • public static object PopObject()
  • public static IDisposable Push(string text)
• public static class ScopeContext
• public static class SetupBuilderExtensions
  • public static ISetupBuilder LoadConfigurationFromAssemblyResource(this ISetupBuilder setupBuilder, Assembly applicationAssembly, string resourceName = "NLog.config")
  • public static ISetupBuilder LoadConfigurationFromFile(this ISetupBuilder setupBuilder, IEnumerable<string> candidateFilePaths, bool optional = true)
  • public static ISetupBuilder ReloadConfiguration(this ISetupBuilder setupBuilder)
  • public static ISetupBuilder SetupLogFactory(this ISetupBuilder setupBuilder, Action<ISetupLogFactoryBuilder> logfactoryBuilder)
• public static class SetupExtensionsBuilderExtensions
  • public static ISetupExtensionsBuilder AutoLoadExtensions(this ISetupExtensionsBuilder setupBuilder)
  • public static ISetupExtensionsBuilder RegisterConditionMethod(this ISetupExtensionsBuilder setupBuilder, string name, Func<LogEventInfo, object> conditionMethod)
  • public static ISetupExtensionsBuilder RegisterConditionMethod(this ISetupExtensionsBuilder setupBuilder, string name, Func<object> conditionMethod)
  • public static ISetupExtensionsBuilder RegisterLayout<T>(this ISetupExtensionsBuilder setupBuilder, string typeAlias = null) where T : Layout
  • public static ISetupExtensionsBuilder RegisterLayout(this ISetupExtensionsBuilder setupBuilder, string typeAlias, Type layoutType)
  • public static ISetupExtensionsBuilder RegisterLayoutRenderer(this ISetupExtensionsBuilder setupBuilder, string name, Func<LogEventInfo, object> layoutMethod, LayoutRenderOptions options)
  • public static ISetupExtensionsBuilder RegisterLayoutRenderer(this ISetupExtensionsBuilder setupBuilder, string name, Func<LogEventInfo, LoggingConfiguration, object> layoutMethod, LayoutRenderOptions options)
  • public static ISetupExtensionsBuilder RegisterServiceProvider(this ISetupExtensionsBuilder setupBuilder, IServiceProvider serviceProvider)
  • public static ISetupExtensionsBuilder RegisterSingletonService<T>(this ISetupExtensionsBuilder setupBuilder, T singletonService)
  • public static ISetupExtensionsBuilder RegisterSingletonService(this ISetupExtensionsBuilder setupBuilder, Type interfaceType, object singletonService)
• public static class SetupInternalLoggerBuilderExtensions
  • public static ISetupInternalLoggerBuilder SetupFromEnvironmentVariables(this ISetupInternalLoggerBuilder setupBuilder)
• public static class SetupLoadConfigurationExtensions
• public static class SetupLogFactoryBuilderExtensions

NLog.Common

• public struct AsyncLogEventInfo
  • public bool Equals(AsyncLogEventInfo other)

NLog.Config

• public class ConfigurationItemFactory
  • public IJsonSerializer JsonSerializer { get; set; }
• public interface ISetupConfigurationLoggingRuleBuilder : ISetupConfigurationTargetBuilder
• public interface ISetupConfigurationTargetBuilder
• public interface ISetupLogFactoryBuilder
• public interface IUsesStackTrace
• public class LoggingConfiguration
  • public bool ExceptionLoggingOldStyle { get; set; }
  • public IDictionary<string, Layout> Variables { get; }
  • public IDictionary<string, SimpleLayout> Variables { get; }
  • public void AddRule(LoggingRule rule)
  • protected void PrepareForReload(LoggingConfiguration oldConfig)
• public class LoggingConfigurationChangedEventArgs : EventArgs
  • public LoggingConfiguration NewConfiguration { get; }
  • public LoggingConfiguration OldConfiguration { get; }
• public class LoggingRule
  • public FilterResult FilterDefaultAction { get; set; }
  • public LogLevel FinalMinLevel { get; set; }
• public sealed class NLogDependencyResolveException : Exception
• public abstract class ServiceRepository : IServiceProvider
• public class ServiceRepositoryUpdateEventArgs : EventArgs
• public enum StackTraceUsage
  • WithCallSite = 4
  • WithCallSiteClassName = 8
  • WithFileNameAndLineNumber = 2
  • WithStackTrace = 1

NLog.Internal

• public interface IUsesStackTrace
  • StackTraceUsage StackTraceUsage { get; }
• public static class StreamHelpers
  • public static void Copy(this Stream input, Stream output)
  • public static void CopyAndSkipBom(this Stream input, Stream output, Encoding encoding)
  • public static void CopyWithOffset(this Stream input, Stream output, int offset)
• public static class StringHelpers
• public static class XmlHelper
  • public static void WriteAttributeSafeString(this XmlWriter writer, string prefix, string localName, string ns, string value)
  • public static void WriteAttributeSafeString(this XmlWriter writer, string localName, string value)
  • public static void WriteElementSafeString(this XmlWriter writer, string prefix, string localName, string ns, string value)
  • public static void WriteSafeCData(this XmlWriter writer, string text)

NLog.LayoutRenderers

• public class AllEventPropertiesLayoutRenderer : LayoutRenderer
  • public CultureInfo Culture { get; set; }
  • public LayoutRenderer FixScopeContext { get; }
  • public bool IncludeCallerInformation { get; set; }
  • public bool IncludeScopeProperties { get; set; }
• public class AppDomainLayoutRenderer : LayoutRenderer
  • public AppDomainLayoutRenderer(IAppDomain currentDomain)
• public class AssemblyVersionLayoutRenderer : LayoutRenderer
  • public string Default { get; set; }
  • protected virtual Assembly GetAssembly()
• public class BaseDirLayoutRenderer : LayoutRenderer
  • public BaseDirLayoutRenderer(IAppDomain appDomain)
• public class CounterLayoutRenderer : LayoutRenderer
  • public long Value { get; set; }
  • public int Value { get; set; }
• public class DirectorySeparatorLayoutRenderer : LayoutRenderer, IRawValue
  • public bool TryGetRawValue(LogEventInfo logEvent, out object value)
• public class EventContextLayoutRenderer : LayoutRenderer
  • public string Item { get; set; }
  • public EventContextLayoutRenderer()
• public class EventPropertiesLayoutRenderer : LayoutRenderer, IRawValue, IStringValueRenderer
  • public bool IgnoreCase { get; set; }
• public class ExceptionDataLayoutRenderer : LayoutRenderer
• public class FuncLayoutRenderer : LayoutRenderer, IStringValueRenderer
  • public CultureInfo Culture { get; set; }
• public class GdcLayoutRenderer : LayoutRenderer, IRawValue, IStringValueRenderer
  • public CultureInfo Culture { get; set; }
• public abstract class LayoutRenderer : ISupportsInitialize, IRenderable, IDisposable
  • protected IValueFormatter ValueFormatter { get; }
  • public void Dispose()
  • protected virtual void Dispose(bool disposing)
  • protected T ResolveService<T>()
• public enum LevelFormat
  • OneLetter = 1
  • TriLetter = 4
• public class LevelLayoutRenderer : LayoutRenderer, IRawValue, IStringValueRenderer
  • public bool Uppercase { get; set; }
• public class Log4JXmlEventLayoutRenderer : LayoutRenderer, IUsesStackTrace, IIncludeContext
  • public Layout AppInfo { get; set; }
  • public string AppInfo { get; set; }
  • public bool IncludeEventProperties { get; set; }
  • public bool IncludeScopeNested { get; set; }
  • public bool IncludeScopeProperties { get; set; }
  • public string ScopeNestedSeparator { get; set; }
  • public bool WriteThrowableCData { get; set; }
  • public Log4JXmlEventLayoutRenderer(IAppDomain appDomain)
• public class ProcessTimeLayoutRenderer : LayoutRenderer, IRawValue
  • public CultureInfo Culture { get; set; }
• public sealed class ScopeContextIndentLayoutRenderer : LayoutRenderer
• public sealed class ScopeContextNestedStatesLayoutRenderer : LayoutRenderer
• public sealed class ScopeContextPropertyLayoutRenderer : LayoutRenderer, IStringValueRenderer
• public sealed class ScopeContextTimingLayoutRenderer : LayoutRenderer
• public class StackTraceLayoutRenderer : LayoutRenderer, IUsesStackTrace
  • public bool Reverse { get; set; }
• public class TimeLayoutRenderer : LayoutRenderer, IRawValue
  • public CultureInfo Culture { get; set; }
• public class VariableLayoutRenderer : LayoutRenderer
  • public Layout ActiveLayout { get; }

NLog.LayoutRenderers.Wrappers

• public sealed class LowercaseLayoutRendererWrapper : WrapperLayoutRendererBuilderBase
  • public bool ToLower { get; set; }
• public class ObjectPathRendererWrapper : WrapperLayoutRendererBase, IRawValue
  • public bool TryGetPropertyValue(object sourceObject, out object propertyValue)
  • public bool TryGetRawValue(LogEventInfo logEvent, out object value)
• public sealed class OnExceptionLayoutRendererWrapper : WrapperLayoutRendererBase
  • public Layout Else { get; set; }
• public sealed class OnHasPropertiesLayoutRendererWrapper : WrapperLayoutRendererBase
  • public Layout Else { get; set; }
• public sealed class UppercaseLayoutRendererWrapper : WrapperLayoutRendererBuilderBase
  • public bool ToUpper { get; set; }
• public sealed class WhenLayoutRendererWrapper : WrapperLayoutRendererBuilderBase, IRawValue
  • public bool TryGetRawValue(LogEventInfo logEvent, out object value)

NLog.Layouts

• public class JsonArrayLayout : Layout
• public class JsonAttribute
  • public Layout DefaultValue { get; set; }
  • public Type ValueType { get; set; }
• public class JsonLayout : Layout
  • public bool IncludeEventProperties { get; set; }
  • public bool IncludeScopeProperties { get; set; }
  • public bool IndentJson { get; set; }
• public abstract class Layout : ISupportsInitialize, IRenderable
  • protected LoggingConfiguration LoggingConfiguration { get; }
  • public void Render(LogEventInfo logEvent, StringBuilder target)
  • protected T ResolveService<T>()
• public sealed class Layout<T> : Layout, ITypedLayout, IEquatable<T>
• public class Log4JXmlEventLayout : Layout, IIncludeContext
  • public Layout AppInfo { get; set; }
  • public bool IncludeEventProperties { get; set; }
  • public bool IncludeScopeNested { get; set; }
  • public bool IncludeScopeProperties { get; set; }
  • public Layout LoggerName { get; set; }
  • public bool WriteThrowableCData { get; set; }
• public class SimpleLayout : Layout, IUsesStackTrace
  • public IEnumerable<LayoutRenderer> LayoutRenderers { get; }
• public sealed class ValueTypeLayoutInfo
• public class XmlAttribute
  • public Layout DefaultValue { get; set; }
  • public Type ValueType { get; set; }
• public class XmlElement : XmlElementBase
  • public Layout Layout { get; set; }
• public abstract class XmlElementBase : Layout
  • public bool IncludeEventProperties { get; set; }
  • public bool IncludeScopeProperties { get; set; }

NLog.Targets

• public sealed class DebugSystemTarget : TargetWithLayoutHeaderAndFooter
• public class DatabaseCommandInfo
  • public CommandType CommandType { get; set; }
  • public Layout ConnectionString { get; set; }
  • public bool IgnoreFailures { get; set; }
  • public IList<DatabaseParameterInfo> Parameters { get; }
  • public Layout Text { get; set; }
  • public DatabaseCommandInfo()
• public class DatabaseObjectPropertyInfo
  • public CultureInfo Culture { get; set; }
  • public string Format { get; set; }
  • public Layout Layout { get; set; }
  • public string Name { get; set; }
  • public Type PropertyType { get; set; }
  • public DatabaseObjectPropertyInfo()
• public class DatabaseParameterInfo
  • public bool AllowDbNull { get; set; }
  • public CultureInfo Culture { get; set; }
  • public string DbType { get; set; }
  • public string Format { get; set; }
  • public Layout Layout { get; set; }
  • public string Name { get; set; }
  • public Type ParameterType { get; set; }
  • public byte Precision { get; set; }
  • public byte Scale { get; set; }
  • public int Size { get; set; }
  • public DatabaseParameterInfo()
  • public DatabaseParameterInfo(string parameterName, Layout parameterLayout)
• public class DatabaseTarget : Target, IInstallable
  • public IList<DatabaseObjectPropertyInfo> CommandProperties { get; }
  • public Layout CommandText { get; set; }
  • public CommandType CommandType { get; set; }
  • public IList<DatabaseObjectPropertyInfo> ConnectionProperties { get; }
  • public Layout ConnectionString { get; set; }
  • public Layout DBDatabase { get; set; }
  • public Layout DBHost { get; set; }
  • public Layout DBPassword { get; set; }
  • public string DBProvider { get; set; }
  • public Layout DBUserName { get; set; }
  • public Layout InstallConnectionString { get; set; }
  • public IList<DatabaseCommandInfo> InstallDdlCommands { get; }
  • public IsolationLevel? IsolationLevel { get; set; }
  • public bool KeepConnection { get; set; }
  • public IList<DatabaseParameterInfo> Parameters { get; }
  • public IList<DatabaseCommandInfo> UninstallDdlCommands { get; }
  • public bool? UseTransactions { get; set; }
  • public DatabaseTarget()
  • public DatabaseTarget(string name)
  • protected string BuildConnectionString(LogEventInfo logEvent)
  • protected virtual IDbDataParameter CreateDatabaseParameter(IDbCommand command, DatabaseParameterInfo parameterInfo)
  • public void Install(InstallationContext installationContext)
  • public bool? IsInstalled(InstallationContext installationContext)
  • public void Uninstall(InstallationContext installationContext)
• public class FileTarget : TargetWithLayoutHeaderAndFooter, ICreateFileParameters
  • public int maxLogFilenames { get; set; }
• public interface IJsonSerializer
  • string SerializeObject(object value)
• public sealed class LineEndingMode : IEquatable<LineEndingMode>
  • public class LineEndingModeConverter : TypeConverter
• public class MethodCallParameter
  • public Layout DefaultValue { get; set; }
  • public object RenderValue(LogEventInfo logEvent)
• public class NetworkLogEventDroppedEventArgs : EventArgs
• public enum NetworkLogEventDroppedReason
• public class NetworkTarget : TargetWithLayout
  • public NetworkTargetCompressionType Compress { get; set; }
  • public int CompressMinBytes { get; set; }
  • public NetworkTargetQueueOverflowAction OnQueueOverflow { get; set; }
  • public event EventHandler<NetworkLogEventDroppedEventArgs> LogEventDropped
• public enum NetworkTargetCompressionType
• public enum NetworkTargetConnectionsOverflowAction
  • Discard = 1
  • Grow = 0
• public enum NetworkTargetQueueOverflowAction
• public class NLogViewerTarget : NetworkTarget, IIncludeContext
  • public Layout AppInfo { get; set; }
  • public string AppInfo { get; set; }
  • public bool IncludeEventProperties { get; set; }
  • public bool IncludeScopeNested { get; set; }
  • public bool IncludeScopeProperties { get; set; }
  • public string ScopeNestedSeparator { get; set; }
• public sealed class OutputDebugStringTarget : TargetWithLayout
  • public OutputDebugStringTarget()
  • public OutputDebugStringTarget(string name)
• public abstract class Target : ISupportsInitialize, IInternalLoggerContext, IDisposable
  • public bool LayoutWithLock { get; set; }
  • protected T RenderLogEvent<T>(Layout<T> layout, LogEventInfo logEvent, T defaultValue = null)
  • protected T ResolveService<T>()
  • protected virtual void Write(AsyncLogEventInfo[] logEvents)
  • protected virtual void WriteAsyncThreadSafe(AsyncLogEventInfo[] logEvents)
  • protected virtual void WriteFailedNotInitialized(AsyncLogEventInfo logEvent, Exception initializeException)
• public class TargetPropertyWithContext
  • public Layout DefaultValue { get; set; }
  • public object RenderValue(LogEventInfo logEvent)
• public abstract class TargetWithContext : TargetWithLayout, IIncludeContext
  • public ISet<string> ExcludeProperties { get; set; }
  • public bool IncludeScopeNested { get; set; }
  • public bool IncludeScopeProperties { get; set; }
  • protected virtual IList<object> CaptureScopeContextNested(LogEventInfo logEvent)
  • protected virtual IDictionary<string, object> CaptureScopeContextProperties(LogEventInfo logEvent, IDictionary<string, object> contextProperties)
  • protected IList<object> GetScopeContextNested(LogEventInfo logEvent)
  • protected IDictionary<string, object> GetScopeContextProperties(LogEventInfo logEvent)
  • protected virtual bool SerializeScopeContextNestedState(LogEventInfo logEvent, object value, out object serializedValue)
  • protected virtual bool SerializeScopeContextProperty(LogEventInfo logEvent, string name, object value, out object serializedValue)
• public sealed class WebServiceTarget : MethodCallTargetBase
  • public Layout ProxyAddress { get; set; }
  • public string ProxyAddress { get; set; }
  • public Layout<Uri> Url { get; set; }
  • public Uri Url { get; set; }

NLog.Targets.Wrappers

• public class BufferingTargetWrapper : WrapperTargetBase
  • public Layout<int> BufferSize { get; set; }
  • public Layout<int> FlushTimeout { get; set; }
  • public int BufferSize { get; set; }
  • public int FlushTimeout { get; set; }
• public class FallbackGroupTarget : CompoundTargetBase
  • public bool EnableBatchWrite { get; set; }
• public class LimitingTargetWrapper : WrapperTargetBase
  • public Layout<TimeSpan> Interval { get; set; }
  • public Layout<int> MessageLimit { get; set; }
  • public TimeSpan Interval { get; set; }
  • public DateTime IntervalResetsAt { get; }
  • public int MessageLimit { get; set; }
• public class RetryingTargetWrapper : WrapperTargetBase
  • public bool EnableBatchWrite { get; set; }
  • public Layout<int> RetryCount { get; set; }
  • public Layout<int> RetryDelayMilliseconds { get; set; }
  • public int RetryCount { get; set; }
  • public int RetryDelayMilliseconds { get; set; }