Dodawanie źródeł danych w aplikacjach ADO.NET (.NET Framework)
Podczas pracy z narzędziami danych platformy .NET w programie Visual Studio można dodawać źródła danych (obiekty .NET), aby połączyć aplikację .NET z informacjami w magazynach danych. Projektanci programu Visual Studio mogą korzystać z danych wyjściowych źródła danych, aby wygenerować standardowy kod, który wiąże dane z formularzami podczas przeciągania i upuszczania obiektów bazy danych z okna Źródła danych.
Przykłady źródeł danych to:
Klasa w modelu platformy Entity Framework skojarzona z jakąś bazą danych
Zestaw danych skojarzony z jakąś bazą danych
Klasa reprezentująca usługę sieciową, taką jak usługa danych Windows Communication Foundation (WCF) lub usługa REST
Klasa reprezentująca usługę programu SharePoint
Klasa lub kolekcja w rozwiązaniu
Uwaga
Zestawy danych i powiązane klasy to starsze technologie .NET Framework z początku 2000 roku, które umożliwiają aplikacjom pracę z danymi w pamięci, gdy aplikacje są odłączone od bazy danych. Technologie te są szczególnie przydatne w przypadku aplikacji, które umożliwiają użytkownikom modyfikowanie danych i utrwalanie zmian z powrotem w bazie danych. Mimo że zestawy danych okazały się bardzo udaną technologią, zalecamy, aby nowe aplikacje platformy .NET używały platformy Entity Framework Core. Program Entity Framework zapewnia bardziej naturalny sposób pracy z danymi tabelarycznymi jako modelami obiektów i ma prostszy interfejs programowania.
Wymagania wstępne
Aplikacja, która implementuje obiekty Windows Forms lub Windows Presentation Format (WPF), które są przeznaczone dla platformy .NET Framework. Ten typ aplikacji można utworzyć przy użyciu szablonu w programie Visual Studio, gdy instalacja obejmuje obciążenie programowanie aplikacji .NET Desktop. Aby uzyskać więcej informacji, zobacz Modyfikowanie obciążeń, składników i pakietów językowych programu Visual Studio.
Ważne
Funkcje opisane w tym artykule nie są obsługiwane w przypadku programowania na platformie .NET Core dla platformy WPF lub Windows Forms.
Aplikacja musi używać funkcji powiązania danych: zestawów danych, platformy Entity Framework, zapytania zintegrowanego języka (LINQ) do języka SQL, usługi danych WCF lub programu SharePoint.
Napiwek
Jeśli aplikacja nie używa co najmniej jednego z tych składników, pojęcie "źródła danych" nie ma zastosowania. W tych scenariuszach można połączyć się bezpośrednio z bazą danych przy użyciu obiektów klasy SqlCommand.
Praca ze źródłami danych i formularzami systemu Windows
Źródła danych dla platformy .NET Framework można tworzyć i edytować przy użyciu Kreatora konfiguracji źródła danych w aplikacji Windows Forms lub WPF. Źródło danych można utworzyć na podstawie bazy danych, usługi, obiektu lub z listy programu SharePoint:
Po utworzeniu źródeł danych są one widoczne w oknie Źródła danych. Po otwarciu projektu w programie Visual Studio możesz uzyskać dostęp do tego okna, wybierając pozycję Wyświetl>inne źródła danych systemu Windows.> Możesz również użyć skrótu klawiaturowego Shift+Alt+D.
W projekcie Windows Forms przeznaczonym dla platformy .NET Framework (nie .NET Core lub .NET 5 lub nowszej) możesz przeciągnąć źródło danych z okna Źródła danych na powierzchnię projektową lub kontrolkę formularza systemu Windows. Oto kilka przykładów sposobu łączenia źródła danych z formularzem:
Przeciągnij tabelę, aby pobrać element BindingNavigator i element DataGridView dla tabeli.
Przeciągnij określoną kolumnę, aby uzyskać element BindingNavigator z etykietą i polem tekstowym dla kolumny.
Przeciągnij wszystkie kolumny tabeli, aby uzyskać pełny formularz wyświetlania danych dla tabeli.
Te akcje wyzwalają program Visual Studio, aby wygenerować standardowy kod, który wyświetla dane z magazynu danych. W poniższym przykładzie pokazano zestaw danych porzucony w formularzu systemu Windows. W przypadku wybrania F5 w aplikacji dane z bazowej bazy danych będą wyświetlane w kontrolkach formularza.
Tworzenie źródła danych na podstawie pliku bazy danych lub bazy danych
Zestaw danych lub model programu Entity Framework można utworzyć do użycia jako źródło danych dla bazy danych lub pliku bazy danych za pomocą Kreatora konfiguracji źródła danych. Jeśli konfiguracja korzysta z programu Entity Framework, najpierw utwórz klasy jednostek, a następnie użyj kreatora do utworzenia źródeł danych.
Tworzenie zestawu danych jako źródła danych
Kreator konfiguracji źródła danych udostępnia opcję utworzenia źródła danych przez nawiązanie połączenia z bazą danych. Możesz wybrać obiekty bazy danych, które mają być używane jako zestaw danych dla aplikacji.
Wykonaj następujące kroki, aby utworzyć zestaw danych jako źródło danych:
W programie Visual Studio wybierz pozycję Project Add New Data Source (Dodaj>nowe źródło danych), aby otworzyć Kreatora konfiguracji źródła danych.
Dla typu źródła danych wybierz pozycję Baza danych.
Dla modelu bazy danych wybierz pozycję Zestaw danych.
Postępuj zgodnie z monitami, aby określić nowe lub istniejące połączenie z bazą danych albo plik bazy danych.
Wybierz obiekty bazy danych do uwzględnienia w zestawie danych i ukończ pracę kreatora.
Aby uzyskać szczegółowe instrukcje dotyczące ukończenia pracy kreatora, zobacz Tworzenie i konfigurowanie zestawów danych w programie .NET Framework za pomocą programu Visual Studio.
Tworzenie modelu programu Entity Framework jako źródła danych
Gdy konfiguracja korzysta z programu Entity Framework, należy najpierw utworzyć klasy jednostek, a następnie utworzyć źródło danych za pomocą Kreatora konfiguracji źródła danych.
Wykonaj następujące kroki, aby utworzyć model platformy Entity Framework jako źródło danych za pomocą Kreatora modelu danych jednostki:
Wybierz pozycję Project Add New Item (Dodaj nowy element projektu>). Zostanie otwarte okno dialogowe Dodawanie nowego elementu .
W oknie dialogowym wybierz szablon ADO.NET Entity Data Model , wprowadź nazwę wystąpienia modelu i wybierz pozycję Dodaj:
Zostanie otwarty Kreator modelu danych jednostki.
W kreatorze wybierz metodę, aby wygenerować model platformy Entity Framework:
Projektant EF z bazy danych: tworzy model w projektancie programu Entity Framework na podstawie istniejącej bazy danych. Możesz wybrać połączenie z bazą danych, ustawienia modelu i obiektów bazy danych do uwzględnienia w modelu. Klasy, z którymi współdziała aplikacja, są generowane na podstawie modelu.
Pusty model projektanta EF: Tworzy pusty model w projektancie platformy Entity Framework jako punkt wyjścia do wizualnego projektowania modelu. Później możesz wygenerować bazę danych na podstawie modelu. Klasy, z którymi współdziała aplikacja, są generowane na podstawie modelu.
Pusty model Code First: tworzy pusty model Code First jako punkt wyjścia do projektowania modelu przy użyciu kodu. Później możesz wygenerować bazę danych na podstawie modelu.
Code First z bazy danych: tworzy model Code First na podstawie istniejącej bazy danych. Możesz wybrać połączenie z bazą danych, ustawienia modelu i obiektów bazy danych do uwzględnienia w modelu.
Po podjęciu wyboru wybierz przycisk Dalej , aby kontynuować w kreatorze.
Dodaj model jako źródło danych dla aplikacji i ukończ pracę kreatora.
Aby uzyskać szczegółowe instrukcje dotyczące ukończenia pracy kreatora, zobacz Tworzenie klas modeli za pomocą platformy Entity Framework (C#).
Po wygenerowaniu klas dla modelu można utworzyć źródło danych na podstawie obiektu za pomocą Kreatora konfiguracji źródła danych.
Wybierz tabele (lub poszczególne kolumny), procedury składowane, funkcje i widoki z modelu do użycia w zestawie danych.
Aby uzyskać szczegółowe instrukcje, zobacz Tworzenie źródła danych na podstawie obiektu.
Tworzenie źródła danych na podstawie usługi
Kreator konfiguracji źródła danych obsługuje tworzenie źródła danych na podstawie usługi. W tym podejściu program Visual Studio dodaje odwołanie do usługi do projektu i tworzy obiekty proxy odpowiadające obiektom zwracanym przez usługę. Gdy usługa zwraca zestaw danych, usługa jest reprezentowana w projekcie jako zestaw danych. Jeśli usługa zwraca określony typ, usługa jest reprezentowana w projekcie jako zwracany typ.
Źródło danych można utworzyć na podstawie następujących typów usług:
Usługi sieci Web
Uwaga
Elementy w oknie Źródła danych są zależne od danych zwracanych przez usługę. Niektóre usługi mogą nie dostarczać wystarczającej ilości informacji dla Kreatora konfiguracji źródła danych, aby utworzyć obiekty możliwe do powiązania. Po zakończeniu pracy kreatora, jeśli usługa zwróci nietypowy zestaw danych, w oknie Źródła danych nie są wyświetlane żadne elementy. Nietypowe zestawy danych nie udostępniają schematu, więc kreator nie ma wystarczającej ilości informacji, aby utworzyć źródło danych.
Wykonaj następujące kroki, aby utworzyć źródło danych na podstawie usługi:
W programie Visual Studio wybierz pozycję Project Add New Data Source (Dodaj>nowe źródło danych), aby otworzyć Kreatora konfiguracji źródła danych.
Dla typu źródła danych wybierz pozycję Usługa.
Zostanie otwarte okno dialogowe Dodawanie odwołania do usługi. Aby uzyskać dostęp do tego okna dialogowego, kliknij prawym przyciskiem myszy projekt w Eksplorator rozwiązań i wybierz polecenie Dodaj odwołanie do usługi.
Aby uzyskać szczegółowe instrukcje dotyczące ukończenia pracy kreatora, zobacz Tworzenie i konfigurowanie zestawów danych w programie .NET Framework za pomocą programu Visual Studio.
Tworzenie źródła danych na podstawie obiektu
Kreator konfiguracji źródła danych umożliwia również utworzenie źródła danych na podstawie dowolnego obiektu, który uwidacznia co najmniej jedną publiczną właściwości.
Wszystkie właściwości publiczne obiektu są widoczne w oknie Źródła danych. Jeśli używasz programu Entity Framework z wygenerowanym modelem, w tym oknie zostaną wyświetlone klasy jednostek, które są źródłami danych dla aplikacji.
Uwaga
Aby obsługiwać powiązanie danych przeciągania i upuszczania, obiekty implementujące ITypedList interfejs lub IListSource muszą mieć konstruktor domyślny. W przeciwnym razie program Visual Studio nie może utworzyć wystąpienia obiektu źródła danych i wyświetli błąd podczas przeciągania elementu na powierzchnię projektową.
Wykonaj następujące kroki, aby utworzyć źródło danych na podstawie obiektu:
W programie Visual Studio wybierz pozycję Project Add New Data Source (Dodaj>nowe źródło danych), aby otworzyć Kreatora konfiguracji źródła danych.
Dla typu źródła danych wybierz pozycję Obiekt.
Na stronie Wybieranie obiektów danych rozwiń węzły w widoku drzewa, aby zlokalizować obiekty, z którymi chcesz powiązać.
Widok drzewa zawiera węzły projektu oraz zestawy i inne projekty, do których odwołuje się projekt.
Aby powiązać z obiektem w zestawie lub projekcie, który nie jest wyświetlany w widoku drzewa, wybierz pozycję Dodaj odwołanie.
Użyj okna dialogowego Menedżer odwołań, aby dodać odwołanie do zestawu lub projektu. Po dodaniu odwołania program Visual Studio dodaje zestaw lub projekt do widoku drzewa.
Uwaga
Może być konieczne skompilowanie projektu zawierającego obiekty, zanim obiekty pojawią się w widoku drzewa.
Aby uzyskać szczegółowe instrukcje dotyczące ukończenia pracy kreatora, zobacz Tworzenie i konfigurowanie zestawów danych w programie .NET Framework za pomocą programu Visual Studio.
Tworzenie źródła danych na podstawie listy programu SharePoint
Możesz również użyć Kreatora konfiguracji źródła danych, aby utworzyć źródło danych z listy programu SharePoint. Program SharePoint uwidacznia dane za pośrednictwem Usługi danych programu WCF, dlatego utworzenie źródła danych programu SharePoint jest takie samo jak tworzenie źródła danych z usługi.
Uwaga
Takie podejście wymaga zestawu SDK programu SharePoint.
Wykonaj następujące kroki, aby utworzyć źródło danych na podstawie listy programu SharePoint:
W programie Visual Studio wybierz pozycję Project Add New Data Source (Dodaj>nowe źródło danych), aby otworzyć Kreatora konfiguracji źródła danych.
Dla typu źródła danych wybierz pozycję SharePoint.
Użyj okna dialogowego Dodawanie dokumentacji usługi, aby nawiązać połączenie z usługą danych programu SharePoint, wskazując program SharePoint Server.
Aby uzyskać szczegółowe instrukcje dotyczące ukończenia pracy kreatora, zobacz Tworzenie i konfigurowanie zestawów danych w programie .NET Framework za pomocą programu Visual Studio.