FileTarget: Add option WriteHeaderWhenInitialFileNotEmpty

src/NLog/Targets/FileTarget.cs

@@ -486,6 +486,11 @@ public bool ArchiveOldFileOnStartup
             set => _archiveOldFileOnStartup = value;
         }
         private bool? _archiveOldFileOnStartup;
+
+        /// <summary>
+        /// Gets or sets a value indicating whether the header should be written on every startup.
+        /// </summary>
+        public bool WriteHeaderOnStartup { get; set; }
 
         /// <summary>
         /// Gets or sets a value of the file size threshold to archive old log file on startup.
@@ -2493,8 +2498,8 @@ private void WriteHeaderAndBom(BaseFileAppender appender)
             if (Header is null && !WriteBom) return;
 
             var length = appender.GetFileLength();
-            //  Write header and BOM only on empty files or if file info cannot be obtained.
-            if (length is null || length == 0)
+            //  Write header and BOM only on empty files or if file info cannot be obtained or WriteHeaderOnStartup is true.
+            if (length is null || length == 0 || WriteHeaderOnStartup)
             {
                 if (WriteBom)
                 {

tests/NLog.UnitTests/Targets/FileTargetTests.cs

@@ -2237,6 +2237,69 @@ public void RepeatingFooterTest(bool writeFooterOnArchivingOnly)
                     Directory.Delete(tempDir, true);
             }
         }
+
+        [Theory]
+        [InlineData(false)]
+        [InlineData(true)]
+        public void WriteHeaderOnStartupTest(bool writeHeaderOnStartup)
+        {
+            var logFile = Path.GetTempFileName() + ".txt";
+            try
+            {
+                const string header = "Headerline";
+
+                 // Configure first time
+                var fileTarget = new FileTarget
+                {
+                    FileName = SimpleLayout.Escape(logFile),
+                    LineEnding = LineEndingMode.LF,
+                    Layout = "${message}",
+                    Header = header,
+                    WriteHeaderOnStartup = true
+                };
+
+                LogManager.Setup().LoadConfiguration(c => c.ForLogger().WriteTo(fileTarget));
+
+                logger.Debug("aaa");
+                logger.Info("bbb");
+                logger.Warn("ccc");
+
+                LogManager.Configuration = null;
+
+                string headerPart = header + LineEndingMode.LF.NewLineCharacters;
+                string logPart = "aaa\nbbb\nccc\n";
+                AssertFileContents(logFile, headerPart + logPart, Encoding.UTF8);
+
+                // Configure second time
+                fileTarget = new FileTarget
+                {
+                    FileName = SimpleLayout.Escape(logFile),
+                    LineEnding = LineEndingMode.LF,
+                    Layout = "${message}",
+                    Header = header,
+                    WriteHeaderOnStartup = writeHeaderOnStartup
+                };
+
+                LogManager.Setup().LoadConfiguration(c => c.ForLogger().WriteTo(fileTarget));
+
+                logger.Debug("aaa");
+                logger.Info("bbb");
+                logger.Warn("ccc");
+
+                LogManager.Configuration = null;    // Flush
+
+                if (writeHeaderOnStartup)
+                    AssertFileContents(logFile, headerPart + logPart + headerPart + logPart, Encoding.UTF8);
+                else
+                    AssertFileContents(logFile, headerPart + logPart + logPart, Encoding.UTF8);
+            }
+            finally
+            {
+                LogManager.Configuration = null;
+                if (File.Exists(logFile))
+                    File.Delete(logFile);
+            }
+        }
 
         [Theory]
         [InlineData(false)]