LINQ to Entities

發行項
05/22/2023

LINQ to Entities 提供了 Language-Integrated Query (LINQ) 支援，可讓開發人員使用 Visual Basic 或 Visual C# 針對 Entity Framework 概念模型撰寫查詢。針對 Entity Framework 執行的查詢是以命令樹查詢來表示，每一個查詢都會針對物件內容來執行。 LINQ to Entities 會將 Language-Integrated Queries (LINQ) 查詢轉換成命令樹查詢、針對 Entity Framework 執行查詢，並傳回 Entity Framework 和 LINQ 都可以使用的物件。下列是建立及執行 LINQ to Entities 查詢的程序：

從 ObjectQuery<T> 建構 ObjectContext 執行個體。
使用 ObjectQuery<T> 執行個體，在 C# 或 Visual Basic 中撰寫 LINQ to Entities 查詢。
將 LINQ 標準查詢運算子和運算式轉換成命令樹。
在命令樹中會針對資料來源查詢執行。執行期間於資料來源上擲回的任何例外狀況都會直接傳遞給用戶端。
將查詢結果傳回用戶端。

建構 ObjectQuery 執行個體

ObjectQuery<T> 泛型類別表示傳回零個或多個具型別實體之集合的查詢。物件查詢通常是從現有的物件內容所建構 (而不是手動建構)，而且一定會屬於該物件內容。此內容提供了撰寫及執行查詢所需的連接和中繼資料 (Metadata) 資訊。 ObjectQuery<T> 泛型類別會實作 IQueryable<T> 泛型介面，此介面的 builder 方法可累加建置 LINQ 查詢。使用 C# var 關鍵字 (在 Visual Basic 中啟用區域型別推斷的話為 Dim)，您也可以讓編譯器推斷實體類型。

撰寫查詢

實作泛型 ObjectQuery<T> 介面之 IQueryable<T> 泛型類別的執行個體會當做 LINQ to Entities 查詢的資料來源。在查詢中，您可以精確地指定想要從資料來源中擷取的資訊。此外，查詢也可以指定該項資訊傳回之前應該如何排序、分組和成形。在 LINQ 中，查詢會儲存在變數內。這個查詢變數不會採取任何動作，也不會傳回任何資料。它只會儲存查詢資訊。在您建立查詢之後，必須執行該查詢以便擷取任何資料。

LINQ to Entities 查詢可以使用兩個不同的語法來撰寫：查詢運算式語法和以方法為基礎的查詢語法。查詢運算式語法和以方法為基礎的查詢語法都是 C# 3.0 和 Visual Basic 9.0 中的新增功能。

如需詳細資訊，請參閱 LINQ to Entities 中的查詢。

查詢轉換

若要針對 Entity Framework 執行 LINQ to Entities 查詢，LINQ 查詢必須轉換成可以針對 Entity Framework 執行的命令樹表示法。

LINQ to Entities 查詢是由 LINQ 標準查詢運算子 (如 Select、Where 和 GroupBy) 與運算式 (x > 10、Contact.LastName 等等) 所組成。 LINQ 運算子並不是由類別所定義，而是類別上的方法。在 LINQ 中，運算式可以包含 System.Linq.Expressions 命名空間內類型所允許的任何項目，以及能以 Lambda 函式表示的任何項目 (依擴充而定)。這是 Entity Framework 所允許之運算式的超集，根據定義，這些運算式限制為只有資料庫上允許且 ObjectQuery<T> 支援的作業。

在 Entity Framework 中，運算子和運算式都是由單一型別階層所代表，然後會將它們置於命令樹中。 Entity Framework 會使用此命令樹來執行查詢。如果 LINQ 查詢不能表示為命令樹，則當轉換查詢時，將會擲回例外狀況。 LINQ to Entities 查詢的轉換牽涉到兩個子轉換：標準查詢運算子的轉換及運算式的轉換。

許多 LINQ 標準查詢運算子沒有 LINQ to Entities 中的有效轉譯。嘗試使用這些運算子將會在查詢轉譯時產生例外狀況。如需所支援 LINQ to Entities 運算子的清單，請參閱支援的和不支援的 LINQ 方法 (LINQ to Entities)。

如需在 LINQ to Entities 中使用標準查詢運算子的詳細資訊，請參閱 LINQ to Entities 查詢中的標準查詢運算子。

一般來說，LINQ to Entities 中的運算式會在伺服器上評估，所以運算式的行為不需要遵循 CLR 語意。如需詳細資訊，請參閱 LINQ to Entities 查詢中的運算式。

如需 CLR 方法呼叫如何對應至資料來源中標準函數的相關資訊，請參閱 CLR 方法與標準函數的對應。

如需如何從 LINQ to Entities 查詢內呼叫標準、資料庫和自訂函數的相關資訊，請參閱在 LINQ to Entities 查詢中呼叫函數。

查詢執行

當使用者建立 LINQ 查詢之後，會將它轉換成與 Entity Framework 相容的表示法 (命令樹的形式)，然後針對資料來源執行此查詢。在執行查詢時，所有的查詢運算式 (或是查詢的元件) 都會在用戶端或伺服器上評估，這包括用於結果具體化或實體投影的運算式。如需詳細資訊，請參閱查詢執行。如需如何將查詢編譯一次然後以不同的參數執行多次來改善效能的詳細資訊，請參閱已編譯查詢 (LINQ to Entities)。

具體化

具體化是將查詢結果以 CLR 型別形式傳回用戶端的程序。在 LINQ to Entities 中，絕對不會傳回查詢結果資料記錄；一定會有支援的 CLR 型別，該型別是由使用者或 Entity Framework 所定義或是由編譯器所產生 (匿名型別)。所有物件具體化都是由 Entity Framework 執行。因為無法在 Entity Framework 與 CLR 之間對應而產生的任何錯誤，都將導致物件具體化期間擲回例外狀況。

查詢結果通常會以下列其中一個項目的形式來傳回：