分享方式：

在 ADO.NET 應用程式中新增資料來源 （.NET Framework）

當您在 Visual Studio 中使用 .NET 資料工具時，您可以新增 數據來源 （.NET 物件），將 .NET 應用程式連線到資料存放區中的資訊。 當您從 [數據來源] 視窗中拖放資料庫物件時，Visual Studio 設計工具可以使用數據來源的輸出來產生將數據綁定至窗體的範本程式碼。

資料來源的範例包括：

  • 與某種資料庫相關聯的 Entity Framework 模型中的類別

  • 與某種資料庫相關聯的數據集

  • 類別，表示網路服務，例如 Windows Communication Foundation （WCF） 數據服務或 REST 服務

  • 表示 SharePoint 服務的類別

  • 方案中的類別或集合

備註

類別 DataSet 和相關類別是 2000 年代初的舊版 .NET Framework 技術，可讓應用程式在應用程式與資料庫中斷連線時使用記憶體中的數據。 這些技術特別適用於可讓使用者修改數據並將變更保存回資料庫的應用程式。 雖然數據集是經過證實的成功技術，但新 .NET 應用程式的建議方法是使用 Entity Framework Core。 Entity Framework 提供更自然的方式，以表格式數據作為物件模型使用，而且具有更簡單的程序設計介面。

先決條件

  • 實作以 .NET Framework 為目標之 Windows Forms 或 Windows 簡報格式 （WPF） 對象的應用程式。 當您的安裝包含 .NET Desktop 開發 工作負載時，您可以在 Visual Studio 中使用範本來建立這種類型的應用程式。 如需詳細資訊，請參閱 修改Visual Studio工作負載、元件和語言套件。

    這很重要

    本文所述的功能不支援 WPF 或 Windows Forms 的 .NET Core 開發。

  • 應用程式必須使用數據系結功能：數據集、Entity Framework、Language Integrated Query （LINQ） 至 SQL、WCF 數據服務或 SharePoint。

    小提示

    當應用程式不使用其中一或多個元件時，「數據源」的概念不適用。 在這些案例中，您可以使用 SqlCommand 類別 物件直接連線到資料庫。

與數據源和 Windows 表單合作

您可以使用 Windows Forms 或 WPF 應用程式中的 [資料源組態精靈 ]，建立和編輯 .NET Framework 的數據源。 您可以從資料庫、服務、物件或 SharePoint 清單建立資料來源：

顯示 Visual Studio 中 [數據源設定精靈] 的螢幕快照。

建立資料源之後，它們會顯示在 [數據源 ] 視窗中。 當您的專案在 Visual Studio 中開啟時，您可以選取 [檢視>其他 Windows>數據源] 來存取此視窗。 您也可以使用 Shift+Alt+D 鍵盤快捷方式。

在以 .NET Framework（而非 .NET Core 或 .NET 5 或更新版本）為目標的 Windows Forms 專案中，您可以將數據來源從 數據來源 視窗拖曳至 Windows 窗體設計介面或控制項。 如何使用表單連接資料來源的一些範例包括：

  • 拖曳一個數據表以取得為該表使用的 BindingNavigator 和 DataGridView。

  • 拖曳特定欄以取得包含該欄的 標籤 和 TextBox 的 BindingNavigator。

  • 拖曳所有數據表數據行，以取得數據表的完整數據檢視表單。

這些動作會觸發 Visual Studio 產生樣板程式碼，以顯示來自資料存放區的數據。 下列範例顯示將資料集拖放到 Windows 表單上。 如果您在應用程式上選取 F5 ，則基礎資料庫中的數據會出現在表單的控制項中。

顯示如何在 Visual Studio 2022 中將數據集拖曳至 Windows 表單的螢幕快照。

顯示如何在 Visual Studio 2019 和更早版本中將數據集拖曳至 Windows 窗體的螢幕快照。

從資料庫或資料庫檔案建立數據源

您可以使用 [數據源組態精靈] 建立數據集或 Entity Framework 模型，作為資料庫或資料庫檔案的數據源。 如果您的組態使用 Entity Framework，請先建立 您的 Entity 類別，然後使用精靈來建立數據源。

建立數據集作為數據源

[數據源組態精靈] 提供連線至資料庫來建立數據源的選項。 您可以選擇要作為應用程式資料集的資料庫物件。

請遵循下列步驟來建立資料集作為資料來源：

  1. 在 Visual Studio 中，選取 [專案>新增數據源 ] 以開啟 [數據源組態精靈]。

  2. 針對數據源的類型，選取 [ 資料庫]。

  3. 針對資料庫模型，選取 [ 數據集]。

  4. 請遵循提示來指定新的或現有的資料庫連接，或資料庫檔案。

  5. 選取要包含在數據集中的資料庫物件，然後完成精靈。

如需完成精靈的詳細指示，請參閱 使用Visual Studio在 .NET Framework 中建立和設定數據集。

建立 Entity Framework 模型作為數據源

當您的組態使用 Entity Framework 時，您會先建立實體類別，然後使用 [數據源 設定精靈] 來建立數據源。

請遵循下列步驟，使用 實體數據模型精靈建立 Entity Framework 模型作為數據源：

  1. 選 取 [專案>] [新增專案]。 [新增品項] 對話框 隨即開啟。

  2. 在對話框中，選取 [ADO.NET 實體數據模型 ] 範本，輸入模型實例的名稱，然後選取 [ 新增]：

    顯示如何使用 [新增專案] 對話方塊建立新 ADO.NET 實體數據模型的螢幕快照。

    實體數據模型精靈開啟。

  3. 在精靈中，選擇方法來產生 Entity Framework 模型：

    • 來自資料庫的 EF 設計工具：根據現有的資料庫，在 Entity Framework Designer 中建立模型。 您可以選擇資料庫連接、模型設定，以及要包含在模型中的資料庫物件。 您的應用程式與其互動的類別是從模型產生。

    • 空白 EF 設計工具模型：在 Entity Framework Designer 中建立空的模型，做為以可視化方式設計模型的起點。 稍後，您可以從模型產生資料庫。 您的應用程式與其互動的類別是從模型產生。

    • 空白 Code First 模型：建立一個空白的 Code First 模型，作為以程式代碼設計模型的起點。 稍後，您可以從模型產生資料庫。

    • Code First from database：根據現有的資料庫建立 Code First 模型。 您可以選擇資料庫連接、模型設定，以及要包含在模型中的資料庫物件。

    此螢幕快照顯示 [實體數據模型精靈] 中產生新模型的選項。

    選擇之後，請選取 下一步 以繼續導引程序。

  4. 將模型新增為應用程式的數據源，然後完成精靈。

    如需完成精靈的詳細指示，請參閱 使用 Entity Framework 建立模型類別 （C#） 。

  5. 產生模型的類別之後，您可以使用 [數據源組態精靈] 從 物件建立數據源。

    • 從模型選取數據表（或個別數據行）、預存程式、函數和檢視表，以用於數據集。

      此螢幕快照顯示數據源組態精靈中模型產生的實體類別。

    如需詳細指示，請參閱 從 物件建立數據源。

從服務建立數據源

[數據源設定精靈] 支援從服務建立數據源。 在此方法中，Visual Studio 會將服務參考新增至您的專案，並建立對應至服務所傳回物件的 Proxy 物件。 當服務傳回數據集時，服務會在專案中以數據集表示。 如果服務傳回特定類型，則服務會在專案中表示為傳回的類型。

您可以從下列服務類型建立資料來源：

備註

[數據源] 視窗中的專案取決於服務傳回的數據。 某些服務可能無法提供足夠的資訊給 [數據源設定精靈 ] 來建立可系結的物件。 完成精靈之後，如果服務傳回不具類型的資料集，[資料來源] 視窗中就不會顯示任何項目。 不具類型的數據集不提供架構，因此精靈沒有足夠的資訊來建立數據源。

請遵循下列步驟，從服務建立數據源：

  1. 在 Visual Studio 中，選取 [專案>新增數據源 ] 以開啟 [數據源組態精靈]。

  2. 針對數據源的類型，選取 [服務]。

    [ 新增服務參考 ] 對話框隨即開啟。 您也可以在方案總管器中，以滑鼠右鍵點擊您的專案，並選取 '新增服務參考'，以存取此對話方塊。

如需完成精靈的詳細指示，請參閱 使用Visual Studio在 .NET Framework 中建立和設定數據集。

從物件建立數據源

[數據源設定精靈] 也可讓您從公開一或多個公用屬性的任何物件建立數據源。

物件的所有公用屬性都會顯示在 [數據源 ] 視窗中。 如果您使用 Entity Framework 搭配產生的模型，此視窗會顯示應用程式數據源的實體類別。

備註

若要支援拖放資料繫結，實作ITypedList或IListSource介面的對象必須有預設建構函式。 否則，Visual Studio 無法具現化數據源物件，並在您將專案拖曳至設計介面時顯示錯誤。

請遵循下列步驟，從物件建立資料來源：

  1. 在 Visual Studio 中，選取 [專案>新增數據源 ] 以開啟 [數據源組態精靈]。

  2. 針對數據源的類型，選取 [物件]。

  3. 在 [ 選取數據物件] 頁面上，展開樹視圖中的節點，找出您要系結的物件。

    樹狀視圖包含專案的節點，以及專案所參考的元件和其他專案的節點。

    1. 若要系結至未出現在樹視圖的元件或專案中的物件，請選取 [加入參考]。

    2. 使用 參考管理員 對話框來加入元件或專案的參考。 新增參考之後，Visual Studio 會將元件或專案新增至樹視圖。

    備註

    您可能需要在對象出現在樹視圖之前，先建置包含物件的專案。

如需完成精靈的詳細指示，請參閱 使用Visual Studio在 .NET Framework 中建立和設定數據集。

從 SharePoint 清單建立數據源

您也可以使用 [數據源組態精靈 ] 從 SharePoint 清單建立數據源。 SharePoint 會透過 WCF Data Services 公開數據，因此建立 SharePoint 數據源與從服務建立數據源相同。

備註

此方法需要 SharePoint SDK。

請遵循下列步驟，從 SharePoint 清單建立資料來源：

  1. 在 Visual Studio 中，選取 [專案>新增數據源 ] 以開啟 [數據源組態精靈]。

  2. 針對數據源的類型，選取 [SharePoint]。

  3. 使用 [ 新增服務參考 ] 對話框，藉由指向 SharePoint Server 連接到 SharePoint 數據服務。

如需完成精靈的詳細指示，請參閱 使用Visual Studio在 .NET Framework 中建立和設定數據集。

相關內容