NET 4.7 如何使用 NLog 将日志记录到数据库

1. 首先安装必要的NuGet包

第一步，咱们得把项目里需要的“砖瓦”——也就是那几个关键的NuGet包——给准备好。具体是下面这几个：

免费影视、动漫、音乐、游戏、小说资源长期稳定更新！ 👉 点此立即查看 👈

• NLog：日志记录的核心库。
• NLog.Config (可选)：如果你想让配置文件自动生成，可以加上这个。

当然，别忘了根据你用的数据库类型，安装对应的提供程序。这里以SQL Server为例：

Install-Package NLog
Install-Package NLog.Config
Install-Package System.Data.SqlClient

2. 配置NLog.config文件

包装好了，接下来就是“施工图纸”了。在项目中添加或修改NLog.config文件，它的核心作用，就是告诉NLog怎么把日志存到数据库里。

我们来看一个基础配置示例。你需要把YourConnectionStringHere替换成自己真实的数据库连接字符串：

如果你的应用对性能比较敏感，担心日志记录拖慢主流程，那异步记录就是个不错的选择。配置上只需要稍作调整：

3. 创建数据库表

光有配置还不行，数据库那头得准备好“仓库”来接收日志。确保你的数据库里有一张结构匹配的表，用来存放登录记录。下面是一个典型的表结构：

CREATE TABLE LoginLogs (
    ID UNIQUEIDENTIFIER PRIMARY KEY,
    LoginName NVARCHAR(100),
    Message NVARCHAR(MAX),
    CreateTime DATETIME
)

4. 在代码中使用NLog记录登录日志

有了配置和表结构，万事俱备，只欠代码。在业务逻辑里调用NLog记录日志就非常直观了。下面是一个封装好的登录服务类示例：

using NLog;

public class LoginService
{
    // 获取当前类的日志记录器实例
    private static readonly Logger Logger = LogManager.GetCurrentClassLogger();

    public void LogLoginAttempt(string loginName, string message, bool isSuccess)
    {
        // 创建日志事件信息，并设定级别和消息内容
        var logEvent = new LogEventInfo
        {
            Level = isSuccess ? LogLevel.Info : LogLevel.Warn,
            Message = message
        };

        // 将业务数据（如登录名）添加到日志事件的属性中，以便在配置的layout里使用
        logEvent.Properties["LoginName"] = loginName;

        // 执行记录
        Logger.Log(logEvent);
    }
}

5. 使用示例

最后，我们来个“实战演练”。如何在具体的登录成功或失败场景中调用上面的服务呢？看下面这两行代码就明白了：

var loginService = new LoginService();

// 成功登录时，记录一条INFO级别的日志
loginService.LogLoginAttempt("john.doe", "User logged in successfully", true);

// 登录失败时（如密码错误），记录一条WARN级别的日志
loginService.LogLoginAttempt("john.doe", "Invalid password", false);

这样一来，不同状态的登录行为就会被清晰地区分并持久化到数据库里，后续无论是排查问题还是做审计分析，都会方便得多。