.net项目使用日志框架log4net

下面我将为您详细讲解“.net项目使用日志框架log4net”的完整攻略。本攻略包括以下几个部分：

1. log4net简介
2. log4net的配置
3. log4net的使用
4. 示例1：在控制台中输出日志
5. 示例2：将日志信息写入数据库

1. log4net简介

log4net是一个强大的、灵活的、线程安全的日志框架。它支持多种输出方式，包括控制台、文件、数据库等。log4net提供了丰富的配置选项，可以满足不同的日志需求。log4net的使用非常方便，只需引用log4net的dll，并通过配置文件来实现。

2. log4net的配置

首先，需要在项目中安装log4net的NuGet包，方法如下：

在Visual Studio中打开NuGet包管理器（在“工具”菜单中选择“NuGet包管理器”），然后搜索log4net，安装最新版本。

安装完成后，需要在应用程序的配置文件中配置log4net的相关参数。我们以一个控制台应用程序为例：

在应用程序的配置文件（App.config或Web.config）中添加以下配置：

<configSections>
  <section name="log4net" type="log4net.Config.Log4NetConfigurationSectionHandler, log4net"/>
</configSections>

<log4net>
  <appender name="ConsoleAppender" type="log4net.Appender.ConsoleAppender">
    <layout type="log4net.Layout.PatternLayout">
      <conversionPattern value="%date{HH:mm:ss} [%thread] %-5level %logger - %message%newline" />
    </layout>
  </appender>

  <root>
    <level value="DEBUG" />
    <appender-ref ref="ConsoleAppender" />
  </root>
</log4net>

其中，<configSections>指定了配置节，<section>指定了log4net配置节，<appender>指定了输出方式（这里是控制台），<layout>指定了日志的格式，<root>设置了日志的默认级别和使用的appender。

3. log4net的使用

现在，我们已经完成了log4net的配置。接下来，我们可以在代码中使用log4net。

在C#中，需要首先定义一个日志对象，如下所示：

private static readonly log4net.ILog log = log4net.LogManager.GetLogger(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);

这个日志对象的命名空间是log4net，它的名称是ILog。在定义日志对象时，我们通常使用当前方法所在的类的Type作为参数，这可以防止使用相同名称的日志对象。

log4net提供了多个方法来输出日志信息，例如：

log.Debug("Debug message");
log.Info("Info message");
log.Warn("Warning message");
log.Error("Error message");
log.Fatal("Fatal message");

在输出日志之前，需要确保log4net已经初始化。可以通过以下方法来初始化log4net：

log4net.Config.XmlConfigurator.Configure(); //默认从app.config中读取配置

或者

log4net.Config.XmlConfigurator.Configure(new System.IO.FileInfo("log4net.config")); //从指定文件中读取配置

4. 示例1：在控制台中输出日志

下面，我们来演示如何使用log4net在控制台中输出日志。

首先，创建一个控制台应用程序，然后安装log4net的NuGet包，配置log4net的相关参数（参见第2部分）。在Main方法中，我们可以使用log.Debug方法来输出日志信息：

static void Main(string[] args)
{
    log4net.Config.XmlConfigurator.Configure();
    log.Debug("Hello, log4net!");
}

运行应用程序，控制台会输出类似以下的信息：

15:52:24 [1] DEBUG MyApp.Program - Hello, log4net!

5. 示例2：将日志信息写入数据库

下面，我们来演示如何使用log4net将日志信息写入数据库。

先在数据库中创建一个用于存储日志的表，如下所示：

CREATE TABLE [dbo].[Log](
    [Id] [int] IDENTITY(1,1) NOT NULL,
    [Date] [datetime] NOT NULL,
    [Thread] [varchar](255) NOT NULL,
    [Level] [varchar](50) NOT NULL,
    [Logger] [varchar](255) NOT NULL,
    [Message] [varchar](max) NOT NULL,
    [Exception] [varchar](max) NULL,
 CONSTRAINT [PK_Log] PRIMARY KEY CLUSTERED 
(
    [Id] ASC
)WITH (PAD_INDEX = OFF, STATISTICS_NORECOMPUTE = OFF, IGNORE_DUP_KEY = OFF, ALLOW_ROW_LOCKS = ON, ALLOW_PAGE_LOCKS = ON) ON [PRIMARY]
) ON [PRIMARY] TEXTIMAGE_ON [PRIMARY]

然后，在log4net的配置文件中添加以下配置项：

<appender name="AdoNetAppender" type="log4net.Appender.AdoNetAppender">
  <bufferSize value="1" />
  <connectionType value="System.Data.SqlClient.SqlConnection, System.Data.SqlClient, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
  <connectionString value="Server=.\SQLEXPRESS;Database=MyDb;Integrated Security=SSPI" />
  <commandText value="INSERT INTO [Log] ([Date],[Thread],[Level],[Logger],[Message],[Exception]) VALUES (@date,@thread,@level,@logger,@message,@exception)" />
  <parameter>
    <parameterName value="@date" />
    <dbType value="DateTime" />
    <layout type="log4net.Layout.RawTimeStampLayout" />
  </parameter>
  <parameter>
    <parameterName value="@thread" />
    <dbType value="String" />
    <size value="255" />
    <layout type="log4net.Layout.PatternLayout">
      <conversionPattern value="%thread" />
    </layout>
  </parameter>
  <parameter>
    <parameterName value="@level" />
    <dbType value="String" />
    <size value="50" />
    <layout type="log4net.Layout.PatternLayout">
      <conversionPattern value="%level" />
    </layout>
  </parameter>
  <parameter>
    <parameterName value="@logger" />
    <dbType value="String" />
    <size value="255" />
    <layout type="log4net.Layout.PatternLayout">
      <conversionPattern value="%logger" />
    </layout>
  </parameter>
  <parameter>
    <parameterName value="@message" />
    <dbType value="String" />
    <size value="max" />
    <layout type="log4net.Layout.PatternLayout">
      <conversionPattern value="%message" />
    </layout>
  </parameter>
  <parameter>
    <parameterName value="@exception" />
    <dbType value="String" />
    <size value="max" />
    <layout type="log4net.Layout.ExceptionLayout" />
  </parameter>
</appender>

这里，我们指定了日志输出到AdoNetAppender中，使用的是SQL Server数据库。其中，<bufferSize>指定了缓冲区大小，<connectionType>指定了数据库连接类型，<connectionString>指定了连接字符串，<commandText>指定了插入日志的SQL语句，<parameter>指定了参数及其对应的值。

最后，在Main方法中，我们可以使用log.Error方法来输出日志信息：

static void Main(string[] args)
{
    log4net.Config.XmlConfigurator.Configure();
    try
    {
        throw new Exception("Test exception");
    }
    catch (Exception ex)
    {
        log.Error("Error message", ex);
    }
}

运行应用程序，检查数据库中是否写入了日志信息。

至此，这个完整攻略就结束了。希望对您有所帮助！