共用方式為

NAVIGATE (Entity SQL)

  • 發行項

在建立於實體之間的關聯性上巡覽。

語法

navigate(instance-expression, [relationship-type], [to-end [, from-end] ])

引數

instance-expression 實體的執行個體。

relationship-type 關聯性的型別名稱，來自概念結構定義語言 (CSDL) 檔案。 relationship-type 限定為 <namespace>.<relationship type name>。

to 關聯性的結束。

from 關聯性的開始。

傳回值

如果結束端的基數為 1，傳回值將會是 Ref<T>。 如果結束端的基數為 n，傳回值將會是 Collection<Ref<T>>。

備註

關聯性是實體資料模型 (EDM) 中的第一類建構。 您可在兩個以上的實體類型之間建立關聯性，讓使用者能夠巡覽其中一端 (實體) 到另一端的關聯性。 關聯性中的名稱解析沒有模稜兩可情況時，可以有條件地選擇from 和 to 。

NAVIGATE 在 O 和 C 空間中有效。

導覽建構的一般形式如下：

navigate(instance-expression, relationship-type, [ to-end [, from-end ] ] )

例如：

Select o.Id, navigate(o, OrderCustomer, Customer, Order)
From LOB.Orders as o

其中 OrderCustomer 是 relationship，而 Customer 和 Order 則是關聯性的 to-end (客戶) 和 from-end (訂單)。 如果 OrderCustomer 是 n 對 1 關聯性，那麼巡覽運算式的結果型別便是 Ref<Customer>。

這個運算式更簡單的形式如下：

Select o.Id, navigate(o, OrderCustomer)
From LOB.Orders as o

同理，在下列形式的查詢中，巡覽運算式將會產生 Collection<Ref<Order>>。

Select c.Id, navigate(c, OrderCustomer, Order, Customer)
From LOB.Customers as c

此執行個體運算式必須是實體/參考型別。

範例

以下 Entity SQL 查詢使用 NAVIGATE 運算子在建立於 Address 和 SalesOrderHeader 實體類型之間的關聯性上巡覽。 此查詢是根據 AdventureWorks Sales Model。 若要編譯及執行此查詢，請遵循以下步驟：

  1. 遵循 How to: Execute a Query that Returns StructuralType Results中的程序進行。

  2. 將下列查詢當成引數，傳遞至 ExecuteStructuralTypeQuery 方法：

SELECT address.AddressID, (SELECT VALUE DEREF(soh) 
FROM NAVIGATE(address, 
    AdventureWorksModel.FK_SalesOrderHeader_Address_BillToAddressID) 
    AS soh)
FROM AdventureWorksEntities.Addresses AS address

另請參閱