共用方式為

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

  • 發行項

當您在 Visual Studio 中使用 .NET 資料工具時，您可以新增資料來源 (.NET 物件) 來連接您的 .NET 應用程式與資料儲存中的資訊。 Visual Studio 設計工具可以取用資料來源輸出，以在從 [資料來源] 視窗中拖放資料庫物件時產生將資料繫結至表單的樣板程式碼。

資料來源的範例包括：

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

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

  • 表示網路服務，例如 Windows Communication Foundation (WCF) 資料服務或 REST 服務的類別

  • 表示 SharePoint 服務的類別

  • 解決方案中的類別或集合

注意

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

必要條件

  • 一個實作 Windows Forms 或 Windows Presentation Foundation (WPF) 物件，目標是 .NET Framework 的應用程式。 您可以在安裝了 .NET 桌面開發工作負載的 Visual Studio 中，使用範本來建立這類型的應用程式。 如需詳細資訊，請參閱修改 Visual Studio 工作負載、元件和語言套件。

    重要

    本文中描述的功能不支援用於 .NET Core 的 WPF 或 Windows Forms 開發。

  • 應用程式必須使用資料繫結功能：資料集、Entity Framework、語言整合查詢 (LINQ) 到 SQL、WCF 資料服務或 SharePoint。

    提示

    當應用程式未使用一個或多個這些元件時，就不適用「資料來源」的概念。 在這些情境下，您可以使用 SqlCommand 類別物件直接連接到資料庫。

使用資料來源和 Windows 表單

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

顯示 Visual Studio 中「資料來源設定精靈」的螢幕擷取畫面。

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

在以 .NET Framework (而非 .NET Core 或 .NET 5 或更新版本) 為目標的 Windows Forms 專案中，您可以將資料來源從 [資料來源] 視窗拖曳至 Windows 表單設計介面或控制項。 以下是一些將資料來源與表單連接的範例：

  • 拖曳資料表，以取得資料表的 BindingNavigator 和 DataGridView。

  • 拖曳特定的欄以取得帶有該欄的 Label 和 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 類別，然後使用 [資料來源設定精靈] 來建立資料來源。

按照以下步驟使用 [實體資料模型精靈] 將 Entity Framework 模型建立為資料來源：

  1. 選取 [專案]>[新增項目]。 [新增項目] 對話方塊隨即開啟。

  2. 在對話方塊中，選取 [ADO.NET 實體資料模型] 範本，輸入模型執行個體的名稱，然後選取 [新增]：

    顯示如何使用 [新增項目] 對話方塊建立新的 ADO.NET 實體資料模型的螢幕擷取畫面。

    [實體資料模型精靈] 隨即開啟。

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

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

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

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

    • 根據資料庫建立 Code First 模型：根據現有資料庫建立 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 伺服器來連接到 SharePoint 資料服務。

有關完成精靈的詳細指示，請參閱 [使用 Visual Studio 在 .NET Framework 中建立和設定資料集]。

相關內容