在程式碼中使用與資料相關的物件

LightSwitch 會產生描述你的資料的物件和成員。這些物件及成員的名稱與您解決方案中的項目名稱相符。例如，如果您加入名為 Customer 的資料表，LightSwitch 就會產生名為 Customer 的物件。本主題說明 LightSwitch 所產生的每個物件類型。若要檢視使用這些物件和成員執行常見資料相關工作的程式碼範例，請參閱使用程式碼執行與資料相關的工作。

產生的物件及成員的階層架構

下圖摘要產生的資料模型物件與成員。

應用程式

Application 物件會提供應用程式中物件的最高等級存取權。若要存取 Application 物件，請在程式碼編輯器中開啟任何使用者程式碼檔案，然後輸入 Application。輸入 Application 並輸入 "." 之後，IntelliSense 中顯示的方法及屬性類型將會根據您撰寫程式碼的程式碼檔案變更。在大多數情況下，您可以使用 Application 物件的屬性取得表示目前使用者的物件。

資料工作區

DataWorkspace 物件是所有資料存取的最上層物件。DataWorkspace 物件包含專案中每個資料來源的屬性。例如，如果您有名為 NorthwindData 的資料來源，LightSwitch 就會產生名為 NorthwinddData 的屬性。當您在 [程式碼編輯器] 中輸入 DataWorkspace 時，下拉式清單中的 NorthwindData 屬性會啟用。

下圖顯示可能會在下拉式清單中出現的一些產生的成員。

Data Source

LightSwitch 會為專案中的每個資料來源產生物件。這個物件包含可以用來存取資料的成員。資料來源物件的成員包括實體集屬性和查詢方法。

下圖顯示可能會在下拉式清單中出現的一些產生的成員。

實體集屬性

實體集屬性會傳回實體的集合。LightSwitch 會為資料來源中的每個實體產生實體集屬性。例如，如果您的資料來源包含名為Customer的實體， LightSwitch就會產生名為Customers的屬性。您可以使用Customers屬性取得表示Customer實體集合的EntitySet物件。

EntitySet 物件還包含可讓您檢查目前使用者是否有使用權限在集合中讀取、更新或刪除實體的成員。如需詳細資訊，請參閱使用程式碼執行與資料相關的工作。

注意事項
EntitySet是幾種實體集合物件的類型之一若要最佳化程式碼的效能，請確定您要撰寫的商務邏輯類型使用了正確的實體集合物件類型。如需詳細資訊，請參閱實體集合物件和效能。

查詢方法

查詢方法會取得查詢的結果。LightSwitch 會您資料來源中定義的每個查詢產生方法。方法的名稱會與查詢的名稱相符。查詢可以傳回單一實體或型別為 IDataServiceQueryable 的實體集合。

注意事項
IDataServiceQueryable<T>是許多實體集合物件類型中的一個類型。若要最佳化程式碼的效能，請確定您要撰寫的商務邏輯類型使用了正確的實體集合物件類型。如需詳細資訊，請參閱實體集合物件和效能。

LightSwitch 預設會為資料來源中的每個實體產生下列查詢方法。

1. <實體名稱>_Single。

2. <實體名稱>_SingleOrDefault。

這兩個方法接受主索引鍵部分，並傳回單一實體物件。如果沒有傳回任何實體，<實體名稱>_Single 方法就會擲回例外狀況，而 <實體名稱>_SingleOrDefault 會方法傳回 Null 值 (在 Visual Basic 中為 Nothing)。

實體

LightSwitch 會為實體集合中的每個實體產生 EntityObject。例如，如果您的程式碼已取回一連串的訂單，這些訂單會包含表示每筆訂單的EntityObject 。EntityObject 包含可用於刪除實體、讀取或更新實體屬性值或取得相關實體的成員。您可以從實體集合物件 (例如 EntitySet) 或透過呼叫傳回實體的查詢方法，取得 EntityObject。如需詳細資訊，請參閱使用程式碼執行與資料相關的工作。

下圖顯示名為 myOrder 的 Order 實體成員。Order實體包含如OrderDate， OrderID，以及Freight等實體屬性。Order 實體也有一些成員，可用來取得相關的 Order_Details 集合和下訂單的 Customer。

在這個範例中，Customer 屬性會傳回 Customer 實體。Customer 實體位在 Customer-Order 關聯性的一端。

Order_Details 屬性會傳回 Order_Details 的集合。Order_Details 實體位在 Order-Order_Details 關聯性的多端。Order_Details集合物件屬於EntityCollection型別。

此圖也顯示一個名為 Order_DetailsQuery的屬性。以 Query 一字結尾的屬性會傳回 IDataServiceQueryable 物件。

注意事項
EntityCollection 和 IDataServiceQueryable 的型別都是實體集合物件。若要最佳化程式碼的效能，請確定您要撰寫的商務邏輯類型使用了正確的實體集合物件類型。如需詳細資訊，請參閱實體集合物件和效能。

實體集合物件和效能

當您使用 LINQ 運算式中的實體集合物件時，LightSwitch 將會執行從伺服器層擷取實體的作業。您所使用的物件類型會決定 LightSwitch 擷取集合中的所有實體還是僅擷取其中的子集。確保程式碼會如預期方式執行，請為您要撰寫的商務邏輯選取最適當的集合物件類型。有兩種類型的實體集合物件： 使LightSwitch從遠端評估 LINQ 運算式的物件，以及使LightSwitch在本機評估 LINQ 運算式的物件。

LINQ 作業:遠端 VS . 本機執行

如果在 LINQ 運算式中使用EntitySet或IDataServiceQueryable物件， LightSwitch會將整個 LINQ 運算式傳遞至伺服器層的資料服務。然後運算式的結果會傳遞回到呼叫程式碼。這種查詢執行類型的執行效能良好，因為只有符合查詢的實體才會傳回給呼叫程式碼。但是資料服務僅支援查詢運算子的子集。如果您的運算式需要其他 LINQ 運算子，請考慮使用其他類型的集合物件。

下圖顯示LINQ 運算式使用IDataServiceQueryable物件。此範例示範 LINQ 作業將整個運算式傳遞給資料服務，並僅傳回符合查詢條件的 Order 實體。

如果您在 LINQ 運算式中使用EntityCollection或IEnumerable物件，則 LightSwitch不會將運算式傳遞至資料服務。相反地， LightSwitch會擷取指定型別的所有實體。然後運算式會在本機套用至整個集合。如果實體集合很龐大，這種類型的查詢執行可能對效能造成不良影響。但是您的程式碼可以使用完整的一組 LINQ 運算子。此外，當您想要將完整集合實體傳遞至程式碼中的其他方法，這種方法可能會有用。

下圖顯示LINQ 運算式使用EntityCollection物件。此範例示範 LINQ 作業擷取特定客戶的所有 Order 實體。然後查詢的條件會在本機套用至整個集合。

範例：取得程式碼中的實體集合物件

下列示範如何取得Northwind 資料庫範例中的Order實體集合。

請參閱

概念

使用程式碼執行與資料相關的工作

在 LightSwitch 中撰寫程式碼

其他資源

資料：應用程式背後的資訊