编程创建NLog JsonLayout时如何传入LoggingConfiguration使变量正常渲染

手动通过new关键字实例化的JsonLayout不会走NLog的配置初始化流程，基类Layout中LoggingConfiguration属性为私有set，仅在布局对象被NLog配置管线加载、绑定到目标Target时自动赋值。直接调用无配置上下文的Render方法时，${var:xxx}这类依赖全局配置的布局渲染器无法读取配置变量，最终输出字段缺失。

Layout基类提供了公开的Initialize方法，调用该方法传入日志配置即可完成LoggingConfiguration属性赋值，无需反射、无需调试窗口操作：

LogManager.Configuration.Variables["myVariable"] = "myVariableValue";
var jsonLayout = new JsonLayout
{
    Attributes =
    {
        new JsonAttribute("@timestamp", "${longdate}"),
        new JsonAttribute("level", "${level}"),
        new JsonAttribute("variable", "${var:myVariable}"),
    },
    IncludeEventProperties = true,
    IncludeGdc = true,
    IncludeScopeProperties = true
};
// 公开API初始化，自动绑定LoggingConfiguration
jsonLayout.Initialize(LogManager.Configuration);

var logEventInfo = new LogEventInfo(LogLevel.Error, "myLogger", "myMessage");
var layoutValue = jsonLayout.Render(logEventInfo);

执行后即可拿到包含variable字段的完整JSON输出。

• 绑定到Target随配置自动初始化
  将手动创建的JsonLayout赋值给任意日志Target（如控制台、文件Target）的Layout属性，再将Target加入NLog全局配置并触发重加载，NLog会在配置生效阶段自动初始化所有关联的布局对象，无需手动调用Initialize：

  var fileTarget = new FileTarget("customFile")
  {
      FileName = "app.log",
      Layout = jsonLayout // 绑定自定义JsonLayout
  };
  LogManager.Configuration.AddTarget(fileTarget);
  LogManager.Configuration.AddRuleForAllLevels(fileTarget);
  LogManager.ReconfigExistingLoggers(); // 触发配置管线自动初始化
  

• 单次渲染时直接传入配置上下文
  如果只是临时渲染日志内容、不需要长期持有JsonLayout实例，可以直接调用带配置参数的Render重载，不需要提前初始化Layout：

  var logEventInfo = new LogEventInfo(LogLevel.Error, "myLogger", "myMessage");
  // 渲染时直接传入配置上下文
  var layoutValue = jsonLayout.Render(logEventInfo, LogManager.Configuration);
  

注意：不建议通过反射修改私有set的LoggingConfiguration属性，NLog版本迭代时内部实现可能调整，上述公开API是官方稳定支持的用法，不存在版本兼容风险。

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