如何让NLog输出数组内容而非数组类型名称？

问题场景 #

示例代码：

var myArray = new int[] { 1, 2, 3, 4 };
logger.Debug("Array content: {0}", myArray);

实际输出（默认调用object.ToString()）：

Array content: System.Int32[]

期望输出：

Array content: 1, 2, 3, 4

手动转换的方式虽然能达到效果：

logger.Debug("Array content: {0}", string.Join(", ", myArray));

但面对大型数组时，提前拼接字符串会带来不必要的性能开销，希望仅在日志实际输出（比如当前启用了Debug级别）时才生成数组内容的字符串。

核心问题：有没有办法让NLog直接记录数组内容，而不是输出它的类型名称？

试过的思路都没走通：

• 查遍NLog渲染器相关资料，没找到修改参数默认渲染逻辑的方法
• 尝试给数组加自定义格式符（比如{0:X}），但数组类型不支持格式设置
• 想过传入委托来延迟执行转换，但NLog日志方法没有对应的重载

可行解决方案 #

方法1：注册全局对象转换逻辑（推荐） #

NLog支持全局注册特定类型的转换逻辑，只有在需要渲染该对象时才会执行转换，完美匹配延迟执行的需求：

// 程序启动时配置一次即可
LogManager.Setup().SetupSerialization(s =>
{
    // 为所有Array类型注册转换逻辑
    s.RegisterObjectTransformation<Array>(array =>
    {
        return string.Join(", ", array.Cast<object>());
    });
});

之后直接用原有日志写法即可：

logger.Debug("Array content: {0}", myArray);

当日志级别符合条件需要输出时，NLog会自动调用注册的转换方法，把数组转成逗号分隔的字符串。

方法2：结构化日志配合转换逻辑 #

如果习惯使用NLog的结构化日志语法（{@}标记复杂对象），可以结合上述转换逻辑：

// 启动时配置
LogManager.Setup().SetupSerialization(s =>
{
    s.RegisterObjectTransformation<Array>(array => 
        string.Join(", ", array.Cast<object>()));
});

日志写法改用结构化参数：

logger.Debug("Array content: {@MyArray}", myArray);

效果和方法1一致，仅在日志输出时执行转换，避免性能浪费。

方法3：封装延迟执行的包装对象 #

如果不想修改全局配置，可以自己写个简单的扩展方法，把数组包装成延迟生成字符串的对象：

public static class NLogArrayExtensions
{
    public static object LazyFormat(this Array array)
    {
        return new Lazy<string>(() => string.Join(", ", array.Cast<object>()));
    }
}

使用时：

logger.Debug("Array content: {0}", myArray.LazyFormat());

Lazy<string>仅在首次调用ToString()时执行拼接逻辑，而NLog只有在需要输出日志时才会调用参数的ToString()，从而实现延迟转换。

方法4：自定义布局渲染器 #

如果需要针对特定日志目标定制数组格式，可以写一个自定义布局渲染器：

[LayoutRenderer("array-content")]
public class ArrayContentRenderer : LayoutRenderer
{
    protected override void Append(StringBuilder builder, LogEventInfo logEvent)
    {
        if (logEvent.Parameters == null) return;
        
        foreach (var param in logEvent.Parameters)
        {
            if (param is Array array)
            {
                var content = string.Join(", ", array.Cast<object>());
                builder.Append(content);
                break;
            }
        }
    }
}

然后在NLog配置文件中注册并使用：

<nlog>
  <extensions>
    <!-- 替换为你的程序集名称 -->
    <add assembly="YourApplicationAssembly"/>
  </extensions>
  <targets>
    <target name="console" type="Console" 
            layout="Array content: ${array-content}"/>
  </targets>
  <rules>
    <logger name="*" minlevel="Debug" writeTo="console"/>
  </rules>
</nlog>

这种方式适合需要针对特定输出目标定制格式的场景。

内容的提问来源于stack exchange，提问作者gehho