共用方式為


基本 LINQ 查詢作業 (C#)

本主題會簡短介紹 LINQ 查詢運算式,以及一些可以在查詢中執行的一般作業。 下列主題會提供更詳細的資訊:

LINQ 查詢運算式 (C# 程式設計手冊)

標準查詢運算子概觀

逐步解說:在 C# 中撰寫查詢 (LINQ)

注意事項注意事項

如果您已經很熟悉 SQL 或 Xquery 之類的查詢語言,則可以略過本主題的大部分內容。請閱讀下一節中的「from 子句」,以了解 LINQ 查詢運算式中的子句順序。

取得資料來源

在 LINQ 查詢中,第一步是指定資料來源。 在 C# 中,與大部分程式設計語言一樣,都必須先宣告變數,才可以使用變數。 在 LINQ 查詢中,則會先使用 from 子句,以引入資料來源 (customers) 和「範圍變數」(Range Variable) (cust)。

//queryAllCustomers is an IEnumerable<Customer> 
var queryAllCustomers = from cust in customers
                        select cust;

範圍變數與 foreach 迴圈 (Loop) 中的反覆運算變數類似,不同處在於查詢運算式不會發生實際反覆運算。 執行查詢時,範圍變數會提供 customers 中每個連續項目的參考。 因為編譯器 (Compiler) 會推斷 cust 的型別,所以您不需要明確指定型別。 let 子句可以引入其他範圍變數。 如需詳細資訊,請參閱let 子句 (C# 參考)

注意事項注意事項

如果是非泛型資料來源 (如 ArrayList),則必須明確指定範圍變數的型別。如需詳細資訊,請參閱如何:使用 LINQ 查詢 ArrayListfrom 子句 (C# 參考)

篩選

最常見的查詢作業可能是套用布林值 (Boolean) 運算式形式的篩選條件。 篩選條件會使查詢只傳回讓運算式變成 true 的項目。 結果是使用 where 子句所產生。 篩選條件實際上會指定要從來源序列中排除的項目。 在下列範例中,只會傳回地址在 London 的 customers。

var queryLondonCustomers = from cust in customers
                           where cust.City == "London" 
                           select cust;

您可以 where 子句中使用熟悉的 C# 邏輯運算子 AND 和 OR,套用所需數目的篩選條件運算式。 例如,若只要傳回來自 "London" AND 名為 "Devon" 的客戶,請撰寫下列程式碼:

where cust.City=="London" && cust.Name == "Devon"

若要傳回來自 London 或 Paris 的客戶,請撰寫下列程式碼:

where cust.City == "London" || cust.City == "Paris"

如需詳細資訊,請參閱where 子句 (C# 參考)

Ordering

通常要排序傳回的資料會很方便。 orderby 子句會根據所排序型別的預設比較子 (Comparer),來排序所傳回序列中的項目。 例如,可以將下列查詢擴充為根據 Name 屬性來排序結果。 因為 Name 是字串,所以預設比較子會執行依字母順序從 A 到 Z 的排序。

var queryLondonCustomers3 = 
    from cust in customers
    where cust.City == "London" 
    orderby cust.Name ascending 
    select cust;

若要以相反方向排序結果 (從 Z 到 A),請使用 orderby…descending 子句。

如需詳細資訊,請參閱orderby 子句 (C# 參考)

群組

group 子句可以根據您所指定的索引鍵來分組結果。 例如,您可以指定應該根據 City 分組結果,讓所有來自 London 或 Paris 的客戶都位在個別群組中。 在此情況下,cust.City 是索引鍵。

// queryCustomersByCity is an IEnumerable<IGrouping<string, Customer>> 
  var queryCustomersByCity =
      from cust in customers
      group cust by cust.City;

  // customerGroup is an IGrouping<string, Customer> 
  foreach (var customerGroup in queryCustomersByCity)
  {
      Console.WriteLine(customerGroup.Key);
      foreach (Customer customer in customerGroup)
      {
          Console.WriteLine("    {0}", customer.Name);
      }
  }

查詢的結尾是 group 子句時,結果會是一份清單的清單。 整份清單中的每個項目都是一個物件,這個物件具有一個 Key 成員,以及一份根據該索引鍵分到一組的所有項目的清單。 逐一查看會產生群組序列的查詢時,必須使用巢狀 foreach 迴圈。 外部迴圈會逐一查看每個群組,而內部迴圈則會逐一查看每個群組的成員。

如果您必須參考群組作業的結果,可以使用 into 關鍵字建立可供進一步查詢的識別項。 下列查詢只會傳回包含不止兩個客戶的群組:

// custQuery is an IEnumerable<IGrouping<string, Customer>> 
var custQuery =
    from cust in customers
    group cust by cust.City into custGroup
    where custGroup.Count() > 2
    orderby custGroup.Key
    select custGroup;

如需詳細資訊,請參閱group 子句 (C# 參考)

聯結

聯結作業會在沒有在資料來源中明確設定關聯模式的序列之間建立關聯。 例如,您可以執行聯結,尋找所有位於相同地點的客戶和經銷商。 在 LINQ 中,join 子句,一律是處理物件集合,而不是直接處理資料庫資料表。

var innerJoinQuery =
    from cust in customers
    join dist in distributors on cust.City equals dist.City
    select new { CustomerName = cust.Name, DistributorName = dist.Name };

因為 LINQ 中的外部索引鍵在物件模型中是以保留項目集合的屬性表示,所以在 LINQ 中,使用 join 的頻率不需要像在 SQL 中那樣地頻繁。 例如,Customer 物件包含 Order 物件的集合。 您可以使用點標記法 (而不是執行聯結) 來存取訂單:

from order in Customer.Orders...

如需詳細資訊,請參閱join 子句 (C# 參考)

選取 (投影)

select 子句會產生查詢結果,並指定每個所傳回項目的「型態」或型別。 例如,您可以指定結果要包含完整 Customer 物件、只包含一個成員、包含成員子集,還是包含根據計算或所建立新物件而得到的完全不同的結果型別。 如果 select 子句的產物不是來源項目的複本,則這項作業稱為「投影」(Projection)。 使用規劃來轉換資料,是 LINQ 查詢運算式的一項強大功能。 如需詳細資訊,請參閱使用 LINQ 轉換資料 (C#)select 子句 (C# 參考)

請參閱

工作

逐步解說:在 C# 中撰寫查詢 (LINQ)

參考

匿名類型 (C# 程式設計手冊)

概念

LINQ 查詢運算式 (C# 程式設計手冊)

基本查詢作業 (Visual Basic)

其他資源

開始使用 C# 中的 LINQ

查詢關鍵字 (C# 參考)