在.NET中，Microsoft.Extensions.Logging是一個廣泛使用的日志庫，用于記錄應用程序的日志信息。它提供了豐富的功能和靈活性，使開發人員能夠輕松地記錄各種類型的日志，并將其輸出到不同的目標，包括日志文件。本文將詳細介紹Microsoft.Extensions.Logging的各種基礎功能以及如何按天生成日志文件。

一、Microsoft.Extensions.Logging基礎功能

1. 創建Logger

首先，我們需要創建一個Logger實例，以便在應用程序中記錄日志。以下是創建Logger的基本方法：

using Microsoft.Extensions.Logging;

var loggerFactory = LoggerFactory.Create(builder =>
{
    builder.AddConsole(); // 輸出日志到控制臺
});

var logger = loggerFactory.CreateLogger<Program>();

在上面的示例中，我們首先創建了一個LoggerFactory實例，然后通過它創建了一個Logger。我們還使用AddConsole方法將日志輸出到控制臺。

2. 記錄日志消息

一旦有Logger實例，我們可以使用它來記錄不同級別的日志消息。
Microsoft.Extensions.Logging定義了以下日志級別（按嚴重性遞增排列）：

• Trace
• Debug
• Information
• Warning
• Error
• Critical

下面是如何使用Logger記錄不同級別的日志消息的示例：

logger.LogInformation("這是一條信息日志");
logger.LogWarning("這是一條警告日志");
logger.LogError("這是一條錯誤日志");
logger.LogCritical("這是一條嚴重錯誤日志");

3. 提供上下文信息

通常，我們需要將一些上下文信息記錄到日志中，以幫助排查問題。可以使用LogInformation等方法的重載版本，傳遞額外的參數，如下：

var userId = 123;
logger.LogInformation("用戶 {UserId} 登錄成功", userId);

在上述示例中，我們將userId作為參數傳遞給日志消息，以便將其包含在日志中。

4. 使用日志范圍

有時，我們希望在一段代碼塊中記錄一組相關日志消息，并希望這些消息具有相同的上下文信息。這時可以使用LogScope，如下所示：

using (logger.BeginScope("交易處理 - 訂單 {OrderId}", orderId))
{
    logger.LogInformation("訂單處理中...");
    // 執行一些訂單處理邏輯
    logger.LogInformation("訂單處理完成");
}

在上述示例中，我們使用BeginScope方法創建了一個日志范圍，將其包含在指定的上下文信息中。在范圍內的所有日志消息都會自動包含這些上下文信息。

5. 配置日志級別

我們可以在應用程序中配置所需的最低日志級別，以決定哪些日志消息將被記錄。通常，這是在應用程序的配置文件中完成的。以下是一個示例：

var loggerFactory = LoggerFactory.Create(builder =>
{
    builder.AddConsole();
    builder.SetMinimumLevel(LogLevel.Information); // 設置最低日志級別
});

在上述示例中，我們使用SetMinimumLevel方法來配置最低日志級別。只有達到或高于指定級別的日志消息才會被記錄。

二、按天生成日志文件

現在，讓我們來看看如何按天生成日志文件。通常，我們會希望將日志消息記錄到文件中，并按日期對日志文件進行歸檔。

1. 安裝相關包

首先，我們需要安裝一些必要的包，以便實現按天生成日志文件。使用NuGet包管理器或.NET CLI可以輕松完成這一步驟：

dotnet add package Microsoft.Extensions.Logging.File

2. 配置文件日志提供程序

接下來，我們需要配置文件日志提供程序，以便將日志消息記錄到文件中。以下是如何配置文件提供程序的示例：

var loggerFactory = LoggerFactory.Create(builder =>
{
    builder.AddFile("logs/myapp-{Date}.txt");
    builder.SetMinimumLevel(LogLevel.Information);
});

在上述示例中，我們使用AddFile方法配置文件日志提供程序，并指定日志文件的名稱模式。{Date}將根據日志消息的日期自動替換為實際日期。

3. 示例代碼

以下是一個完整的示例代碼，演示了如何使用
Microsoft.Extensions.Logging按天生成日志文件：

using System;
using Microsoft.Extensions.Logging;
using Microsoft.Extensions.Logging.File;

class Program
{
    static void Main()
    {
        var loggerFactory = LoggerFactory.Create(builder =>
        {
            builder.AddFile("logs/myapp-{Date}.txt");
            builder.SetMinimumLevel(LogLevel.Information);
        });

        var logger = loggerFactory.CreateLogger<Program>();

        for (int i = 0; i < 10; i++)
        {
            logger.LogInformation("這是一條信息日志 - {LogCount}", i);
        }
    }
}

上述示例中，我們配置了文件日志提供程序，日志文件的名稱模式包含了{Date}，并循環記錄了10條日志消息。每天，日志文件將被歸檔到不同的文件中，以便跟蹤和檢查以前的日志。

Microsoft.Extensions.Logging是.NET中強大的日志庫，可以用于記錄各種類型的日志消息。通過配置文件日志提供程序，我們可以按天生成日志文件，以便更好地管理和分析日志。