共用方式為


DataContext 方法 (O/R 設計工具)

DataContext 方法 (在 Visual Studio 中的 LINQ to SQL 工具的內容中) 是 DataContext 類別的方法,可在資料庫中執行預存程序和函式。

DataContext 類別是一個 LINQ to SQL 類別,可做為 SQL Server 資料庫與該資料庫對應之 LINQ to SQL 實體類別之間的管道。 DataContext 類別包含連接字串資訊,以及用於連線至資料庫和操作資料庫中資料的方法。 根據預設,DataContext 類別包含數個您可呼叫的方法,例如將已更新的資料從 LINQ to SQL 類別傳送至資料庫的 SubmitChanges 方法。 您也可以建立其他對應至預存程序和函式的 DataContext 方法。 換句話說,呼叫這些自訂方法會在 DataContext 方法對應至的資料庫中執行預存程序或函式。 您可以將新的方法加入至 DataContext 類別,方式就和加入方法以擴充任何類別一樣。 不過,在 [O/R 設計工具] 的內容中討論 DataContext 方法時,主要是在討論對應至預存程序和函式的 DataContext 方法。

方法窗格

對應至預存程序和函式的 DataContext 方法會顯示在 [O/R 設計工具] 的 [方法] 窗格中。 [方法] 窗格是與 [實體] 窗格 (主設計介面) 相鄰的窗格。 [方法] 窗格會列出所有使用 [O/R 設計工具] 建立的 DataContext 方法。 [方法] 窗格預設是空的。將預存程序或函式從 [伺服器總管] 或 [資料庫總管] 拖曳至 [O/R 設計工具],就可以建立 DataContext 方法並填入 [方法] 窗格。 如需詳細資訊,請參閱如何:建立對應至預存程序和函式的 DataContext 方法 (O/R 設計工具)

注意

以滑鼠右鍵按一下 [O/R 設計工具],然後按一下 [隱藏方法窗格] 或 [顯示方法窗格],或者使用鍵盤快速鍵 CTRL+1,開啟和關閉方法窗格。

兩種 DataContext 方法

DataContext 方法是指在資料庫中對應至預存程序和函式的方法。 您可以在 [O/R 設計工具] 的 [方法] 窗格上,建立和新增 DataContext 方法。 DataContext 方法有兩種不同的類型:傳回一個或多個結果集的方法,以及不會傳回結果集的方法:

DataContext 方法的傳回型別

將預存程序和函式從 [伺服器總管] 或 [資料庫總管] 拖曳至 [O/R 設計工具] 時,所產生 DataContext 方法的傳回型別會有所不同,取決於項目的置放位置。 如果直接將項目放入現有的實體類別,則建立的 DataContext 方法會具有該實體類別的傳回型別,如果將項目放入 [O/R 設計工具] 的空白區域 (任一窗格中),則建立的 DataContext 方法會傳回自動產生的型別。 自動產生的型別,不僅名稱上符合預存程序或函式名稱,其屬性也會對應至預存程序或函式傳回的欄位。

注意

您可以在將 DataContext 方法加入至方法窗格後,變更方法的傳回型別。 若要檢查或變更 DataContext 方法的傳回型別,請選取該方法,然後檢查 [屬性] 視窗中的 [傳回型別] 屬性。 如需詳細資訊,請參閱如何:變更 DataContext 方法的傳回型別 (O/R 設計工具)

您從資料庫拖曳至 O/R 設計工具介面的物件將會根據資料庫中的物件名稱自動命名。 如果您多次拖曳相同的物件,系統就會在新名稱的結尾新增一個數字,以便區別這些名稱。 當資料庫物件名稱包含空格或是 Visual Basic 或 C# 中不支援的字元時,系統就會使用底線來取代空格或無效字元。