标准.NET与.NET Core的App.config差异及TraceSource示例故障求助

问题根源 #

你推测的没错：.NET Framework会自动从app.config读取<system.diagnostics>节点的Trace配置，但.NET Core（包括.NET 5/6/7+）为了轻量化设计，不再自动加载这部分配置，导致示例代码找不到对应的Trace监听器和开关设置，从而运行崩溃。

解决方案 #

1. 迁移配置到appsettings.json #

把原来.NET Framework项目中app.config里的<system.diagnostics>配置，转换成JSON格式放到appsettings.json中。示例结构如下：

{
  "Logging": {
    "TraceSource": {
      "Sources": {
        "TraceSourceApp": { // 对应你的TraceSource实例名称
          "Switch": "Verbose", // 日志级别，和原配置的switch value一致
          "Listeners": [
            {
              "Name": "consoleListener",
              "Type": "System.Diagnostics.ConsoleTraceListener"
            },
            {
              "Name": "fileListener",
              "Type": "System.Diagnostics.TextWriterTraceListener",
              "Args": "trace-output.log" // 监听器构造参数，比如日志文件路径
            }
          ]
        }
      }
    }
  }
}

注意：右键appsettings.json→属性，将复制到输出目录设置为「始终复制」或「如果较新则复制」，否则运行时无法读取配置文件。

2. 手动加载配置并初始化TraceSource #

在代码中读取appsettings.json的配置，手动绑定到TraceSource实例，替代.NET Framework的自动加载逻辑。示例代码：

using System.Diagnostics;
using Microsoft.Extensions.Configuration;

// 构建配置读取器
var configBuilder = new ConfigurationBuilder()
    .SetBasePath(Directory.GetCurrentDirectory())
    .AddJsonFile("appsettings.json", optional: false, reloadOnChange: true);

IConfiguration config = configBuilder.Build();

// 获取目标TraceSource的配置节点
var sourceConfig = config.GetSection("Logging:TraceSource:Sources:TraceSourceApp");

// 创建TraceSource实例
var traceSource = new TraceSource("TraceSourceApp");

// 设置开关级别
if (Enum.TryParse<SourceLevels>(sourceConfig["Switch"], out var switchLevel))
{
    traceSource.Switch.Level = switchLevel;
}

// 添加配置的监听器
foreach (var listenerSection in sourceConfig.GetSection("Listeners").GetChildren())
{
    var listenerType = Type.GetType(listenerSection["Type"]);
    if (listenerType == null || !typeof(TraceListener).IsAssignableFrom(listenerType))
    {
        continue;
    }

    TraceListener listener;
    // 处理带构造参数的监听器（比如TextWriterTraceListener需要日志文件路径）
    if (listenerSection.ContainsKey("Args"))
    {
        listener = (TraceListener)Activator.CreateInstance(listenerType, listenerSection["Args"]);
    }
    else
    {
        listener = (TraceListener)Activator.CreateInstance(listenerType);
    }

    listener.Name = listenerSection["Name"];
    traceSource.Listeners.Add(listener);
}

// 执行原示例的Trace逻辑
traceSource.TraceEvent(TraceEventType.Information, 1, "Informational message");
traceSource.TraceEvent(TraceEventType.Error, 2, "Error message");

// 清理资源
traceSource.Flush();
traceSource.Close();

3. 安装必要的NuGet包 #

如果项目未引用配置相关包，执行以下命令安装：

dotnet add package Microsoft.Extensions.Configuration.Json

关键注意事项 #

• .NET Core中TraceSource的核心API和.NET Framework一致，但配置加载逻辑完全独立，必须手动绑定。
• 若要简化日志流程，也可以考虑迁移到.NET Core原生的ILogger体系，但如果要保留现有TraceSource代码，上述方案是最直接的兼容方式。

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