在ASP.NET Core C＃中創建自定義中間件

在ASP.NET Core 中創建自定義中間件，可通過編寫類並註冊實現。 1. 創建包含InvokeAsync 方法的類，處理HttpContext 和RequestDelegate next；2. 在Program.cs 中使用UseMiddleware 註冊。中間件適用於日誌記錄、性能監控、異常處理等通用操作，與MVC 過濾器不同，其作用於整個應用，不依賴控制器。合理使用中間件可提升結構靈活性，但應避免影響性能。

在ASP.NET Core 中創建自定義中間件，是擴展請求處理流程的一種靈活方式。它允許你在HTTP 請求進入控制器之前或響應返回客戶端之前插入自定義邏輯，比如日誌記錄、身份驗證前檢查、性能監控等。

什麼是中間件？

中間件是ASP.NET Core 管道中的一環，用來處理每個請求和響應。你可以把它理解為一個“過濾器”，多個中間件按順序串聯起來形成管道。每個中間件可以選擇是否把請求傳遞給下一個節點，或者直接終止流程並返迴響應。

常見的內置中間件包括UseRouting() 、 UseAuthentication()和UseAuthorization() 。而我們需要的是：如何寫一個自己的中間件。

如何編寫自定義中間件

創建自定義中間件通常有兩種方式：

• 使用委託（Delegating Middleware）
• 實現中間件類（Class-based Middleware）

推薦使用類的方式，結構更清晰，也便於測試和維護。

步驟如下：

1. 創建一個類，包含一個Invoke或InvokeAsync方法。
2. 方法接受HttpContext和一個RequestDelegate next參數。
3. 在Startup.cs或Program.cs中註冊該中間件。

示例代碼如下：

 public class MyCustomMiddleware
{
    private readonly RequestDelegate _next;

    public MyCustomMiddleware(RequestDelegate next)
    {
        _next = next;
    }

    public async Task InvokeAsync(HttpContext context)
    {
        // 在這裡添加你的邏輯，例如：
        Console.WriteLine("Before request handled");

        // 繼續執行後續中間件await _next(context);

        Console.WriteLine("After response sent");
    }
}

然後在Program.cs中添加：

 app.UseMiddleware<MyCustomMiddleware>();

注意中間件的註冊順序會影響執行順序，所以要放在合適的位置。

常見應用場景

中間件非常適合用於一些通用的跨請求操作，以下是一些典型場景：

• 日誌記錄：記錄每次請求的路徑、耗時、IP 地址等信息。
• 性能監控：統計每個請求的處理時間，用於分析系統瓶頸。
• 全局異常處理：捕獲未處理異常，統一返回錯誤信息。
• 請求攔截：根據特定條件拒絕請求（如黑名單IP）。
• 設置自定義響應頭：比如添加X-Powered-By或其他標識。

比如，你想記錄每個請求的耗時，可以這樣實現：

 public async Task InvokeAsync(HttpContext context)
{
    var stopwatch = new Stopwatch();
    stopwatch.Start();

    await _next(context);

    stopwatch.Stop();
    Console.WriteLine($"Request {context.Request.Path} took {stopwatch.ElapsedMilliseconds} ms");
}

這種做法對調試和性能優化很有幫助。

中間件與過濾器的區別

有時候會混淆中間件和MVC 過濾器。它們都能做類似的事情，但適用範圍不同：

• 中間件作用於整個應用程序，適用於所有請求，不依賴於MVC 框架。
• 過濾器只對MVC 控制器生效，適合做一些Action 層面的操作，比如參數校驗、結果格式化。

如果你希望對非控制器請求（比如靜態文件）也進行處理，那就必須用中間件。

另外，中間件可以控制整個請求管道的走向，甚至可以在控制器執行前就結束響應。

基本上就這些。寫一個中間件並不復雜，但要注意不要過度使用，避免影響性能。合理利用中間件，能讓你的應用結構更清晰、功能更靈活。

以上是在ASP.NET Core C＃中創建自定義中間件的詳細內容。更多資訊請關注PHP中文網其他相關文章！