一、為何使用 IQueryable

• ToList()

  • 直接觸發 SQL，獲取完整結果。

• IQueryable

  • 延遲執行，支持動態拼接 Where、OrderBy、Skip/Take 等，直到最后調用 ToList() 才生成并執行最終 SQL。

二、定義 QueryObject 用于接收查詢參數

1. 新建 Helpers/QueryObject.cs，聲明需要的查詢條件屬性，并用 [FromQuery] 在 Controller 中接收：

   public class QueryObject
   {
      public string? Symbol { get; set; }
      public string? CompanyName { get; set; }
   }

2. 上述屬性均可為空，便于后續在倉儲層判斷是否參與過濾。

三、更新倉儲接口與實現簽名

在倉儲接口 IStockRepository 中，將原來無參數的 GetAllAsync() 改為接收 QueryObject：

Task<IEnumerable<Stock>> GetAllAsync(QueryObject query);

在 StockRepository 中，修改實現，并使用 AsQueryable() 延遲執行：

public async Task<IEnumerable<Stock>> GetAllAsync(QueryObject query)
{
    var stocksQuery = _context.Stocks.AsQueryable();  // 延遲執行

    // 根據 CompanyName 過濾
    if (!string.IsNullOrWhiteSpace(query.CompanyName))
    {
        stocksQuery = stocksQuery.Where(s =>
            s.CompanyName.Contains(query.CompanyName));
    }

    // 根據 Symbol 過濾
    if (!string.IsNullOrWhiteSpace(query.Symbol))
    {
        stocksQuery = stocksQuery.Where(s =>
            s.Symbol.Contains(query.Symbol));
    }

    // 最后觸發 SQL 并返回結果
    return await stocksQuery.ToListAsync();
}

四、修改 Controller 接口以支持查詢對象

在 StockController 中，調整 GetStocksAsync 接口簽名，使用 [FromQuery] 注入 QueryObject：

[HttpGet]
public async Task<ActionResult<IEnumerable<Stock>>> GetStocksAsync(
    [FromQuery] QueryObject query)
{
    var stocks = await _stockRepository.GetAllAsync(query);
    return Ok(stocks);
}

這樣，客戶端可以通過 URL 查詢參數動態指定過濾條件：

GET /api/stock?companyName=Microsoft&symbol=MSFT

五、Swagger 調試與驗證

1. 運行項目并打開 Swagger UI：
2. 在 GET /api/stock 中填入不同的 companyName 與 symbol 參數組合，點擊 “Try it out” 查看返回結果，確認過濾邏輯生效。

小結

• 掌握了 IQueryable 延遲執行的核心原理。
• 學會了定義靈活的 QueryObject，動態接收多條件查詢參數。
• 在倉儲層通過鏈式調用構建條件，最后才調用 ToListAsync() 開火 SQL。

下一步可在 QueryObject 中加入分頁、排序等更多可選項，進一步豐富 API 的查詢能力。希望對您有所幫助！

原文引自YouTube視頻：https://www.youtube.com/watch?v=vszGxxxfp6s

#你可能也喜歡這些API文章!

深入解析API網關策略：認證、授權、安全、流量處理與可觀測性

火山引擎如何接入API：從入門到實踐的技術指南

深入解析 DeepSeek API 密鑰：獲取、使用與最佳實踐

API 設計原理：從理論到實踐

DeepSeek+dify 工作流應用,自然語言查詢數據庫信息并展示

REST API 基礎：定義、示例及使用方法

如何使用 DeepSeek 構建 AI Agent：終極指南

API 網關集成 SkyWalking 打造全方位日志處理

9個最佳Text2Sql開源項目：自然語言到SQL的高效轉換工具

<rt id="bthz7"></rt>