Wskazówki: tworzenie TableAdapter z wieloma zapytaniami
Opublikowano: sierpień 2016
W tym instruktażu utworzysz TableAdapter w zestawie danych, w którym używana jest Kreator konfiguracji źródła danych. Przewodnik przeprowadzi Cię przez proces tworzenia drugiego zapytania w adapterze TableAdapter za pomocą Edycja TableAdapters w Projektancie obiektów Dataset.
Zadania zilustrowane w tym przewodniku obejmują:
Tworzenie nowego projektu aplikacji systemu Windows.
Tworzenie i konfigurowanie źródła danych w aplikacji przez utworzenie zestawu danych przy użyciu Kreatora konfiguracji źródła danych.
Otwieranie nowych zestawów danych w Projektancie obiektów zestawów danych.
Dodawanie zapytań do TableAdapter za pomocą Kreatora konfiguracji zapytania TableAdapter.
Wymagania wstępne
W celu wykonania instrukcji tego przewodnika są potrzebne:
- Dostęp do bazy danych przykładów Northwind (wersja programu SQL Server lub Access). Aby uzyskać więcej informacji, zobacz Porady: instalacja przykładowych baz danych.
Tworzenie nowej aplikacji dla systemu Windows
Pierwszym krokiem jest utworzenie aplikacji Windows.
Aby utworzyć projekt nowej aplikacji dla systemu Windows
W Visual Studio z menu Plik utwórz nowy projekt.
Wybierz język programowania w okienku Typy projektów.
Kliknij Aplikacja dla systemu Windows w okienku Szablony.
Nazwij projektu TableAdapterQueriesWalkthrough, a następnie kliknij przycisk OK.
Visual Studio dodaje projekt do Eksploratora rozwiązań i wyświetla nowy formularz w projektancie.
Tworzenie źródła danych bazy danych za pomocą TableAdapter
W tym kroku tworzone jest źródło danych za pomocą Kreatora konfiguracji źródła danych na podstawie tabeli Customers w przykładowej bazie danych Northwind. Musisz mieć dostęp do przykładowej bazy danych Northwind do utworzenia połączenia. Aby uzyskać informacje dotyczące konfigurowania przykładowej bazy danych Northwind, zobacz Porady: instalacja przykładowych baz danych.
Aby utworzyć źródło danych
W menu Dane kliknij przycisk Pokaż źródła danych.
W oknie Źródła danych wybierz Dodaj nowe źródło danych aby uruchomić Kreatora konfiguracji źródła danych.
Wybierz Baza danych na stronie Wybierz typ źródła danych, a następnie kliknij Dalej.
Na stronie Wybierz połączenie danych wykonaj jedną z następujących czynności:
Jeśli połączenie danych z przykładową bazą danych Northwind jest dostępne na liście rozwijanej, wybierz je.
—lub—
Wybierz pozycję Nowe połączenie, aby otworzyć okno dialogowe Dodawanie/modyfikowanie połączenia.
Jeśli baza danych wymaga hasła, wybierz opcję dołączenia danych poufnych, a następnie kliknij przycisk Dalej.
Na stronie Zapisz ciąg połączeń do pliku konfiguracyjnego aplikacji kliknij Dalej.
Rozwiń węzeł Tabele na stronie Wybierz obiekty bazy danych.
Wybierz tabelę Klienci, a następnie kliknij przycisk Zakończ.
NorthwindDataSet został dodany do Twojego projektu, a tabela Klienci pojawia się w oknie Źródła danych.
Otwieranie zestawów danych w Projektancie obiektów zestawów danych
Aby otworzyć zestaw danych w Projektancie obiektów Dataset
Kliknij prawym przyciskiem myszy pozycję NorthwindDataset w oknie Źródła danych.
W menu skrótów wybierz polecenie Edycja zestawu danych z projektantem.
W oknie Projektant obiektów Dataset zostanie otwarty obiekt NorthwindDataset.
Dodawane drugiego zapytania do CustomersTableAdapter
Kreator utworzył zestaw danych z tabeli danych Klienci i obiektu CustomersTableAdapter. W tej części instruktażu dodawane jest drugie zapytanie do CustomersTableAdapter.
Aby dodać zapytanie do CustomersTableAdapter
Przeciągnij zapytanie z karty Zestaw danych w Przyborniku na tabelę Klienci.
Zostanie otwarty Edycja TableAdapters.
Zaznacz opcję Użyj instrukcji SQL, a następnie kliknij przycisk Dalej.
Wybierz pozycję Instrukcja SELECT, która zwraca wiersze, a następnie kliknij przycisk Dalej.
Dodaj klauzulę WHERE do zapytania, tak aby wyglądało następująco:
SELECT CustomerID, CompanyName, ContactName, ContactTitle, Address, City, Region, PostalCode, Country, Phone, Fax FROM Customers WHERE City = @City
Uwaga
Jeśli używasz wersji bazy danych Northwind dla programu Access, należy zastąpić parametr @City znakiem zapytania.(SELECT CustomerID, CompanyName, ContactName, ContactTitle, Address, City, Region, PostalCode, Country, Phone, Fax FROM Customers WHERE City = ?)
Na stronie Wybierz metody do generowania nazwij metodę Wypełnij tabelę danychFillByCity.
Uwaga
Metoda dla ustawienia Zwraca DataTable nie jest używana w tym przewodniku, więc możesz wyczyścić to pole wyboru lub pozostawić nazwę domyślną.
Kliknij Dalej, a następnie zakończ pracę kreatora.
Zapytanie FillByCity zostanie dodane do elementu CustomersTableAdapter.
Dodawanie kodu do wykonania dodatkowego zapytania na formularzu
Aby wykonać zapytanie
Wybierz opcję Form1 w oknie Eksplorator rozwiązań i kliknij pozycję Projektant widoków.
Przeciągnij węzeł Klienci z okna Źródła danych na Formularz Form1.
Zmień na widok kodu wybierając Kod w menu Widok.
Zastąp kod w Form1_Load zdaqrzeniu obsługi z następującymi, aby uruchomić FillByCity zapytanie.
string cityValue = "Seattle"; customersTableAdapter.FillByCity(northwindDataSet.Customers, cityValue);
Dim cityValue As String = "Seattle" CustomersTableAdapter.FillByCity(NorthwindDataSet.Customers, cityValue)
Uruchamianie aplikacji
Aby uruchomić aplikację
Naciśnij F5.
Siatka jest wypełniana klientami z ustawieniem City o wartości Seattle.
Następne kroki
Aby dodać funkcjonalność do aplikacji
Dodaj formant TextBox i formant Button i przekaż wartość w polu tekstowym do zapytania. (CustomersTableAdapter.FillByCity(NorthwindDataSet.Customers, TextBox1.Text)).
Dodaj logikę walidacji do ColumnChanging lub zdarzenia RowChanging tabel danych w zestawie danych. Aby uzyskać więcej informacji, zobacz Sprawdzanie poprawności danych w zestawach danych.
Zobacz też
TableAdapter — Przegląd
Tworzenie i konfigurowanie TableAdapters
Porady: tworzenie zapytań TableAdapter
Wskazówki dotyczące danych
Łączenie z danymi w Visual Studio
Przygotowywanie aplikacji na otrzymywanie danych
Pobieranie danych do aplikacji
Powiązanie formantów z danymi w programie Visual Studio
Edytowanie danych w aplikacji