Porady: tworzenie i wykonywanie instrukcji SQL zwracających pojedynczą wartość
Aby wykonać instrukcję SQL, która zwraca jedną wartość, można uruchomić kwerendę TableAdapter, która jest skonfigurowana do uruchamiania instrukcji SQL (na przykład, CustomersTableAdapter.CustomerCount()).
Jeśli aplikacja nie używa TableAdapters, call ExecuteScalar metody obiektu polecenia, ustawienie jej CommandType właściwość, aby Text.("Obiekt polecenia" odnosi się do określonego polecenia dla .NET Framework danych dostawcy aplikacja korzysta.Na przykład, jeśli aplikacja korzysta.NET Framework dostawcy danych dla programu SQL Server, byłoby obiektu command SqlCommand.)
Następujące przykłady przedstawiają metody do wykonania instrukcji SQL, zwracających pojedynczymi wartościami z bazy danych, używając albo TableAdapters lub poleceń obiektów.Aby uzyskać więcej informacji dotyczących wykonywania kwerend z TableAdapters i poleceń, zobacz Wypełnianie zestawu danych danymi.
[!UWAGA]
Na komputerze w poniższych instrukcjach mogą być wyświetlane inne nazwy i lokalizacje niektórych elementów interfejsu użytkownika programu Visual Studio. Te elementy są określane przez numer wersji Visual Studio oraz twoje ustawienia. Aby uzyskać więcej informacji, zobacz Dostosowywanie ustawień środowiska deweloperskiego w Visual Studio.
Wykonywanie instrukcji SQL, które zwracają pojedynczej wartości, przy użyciu TableAdapter
W tym przykładzie przedstawiono tworzenie przy użyciu kwerendy TableAdapter TableAdapter Kreator konfiguracji zapytania, a następnie zawiera informacje na temat zadeklarować wystąpienie TableAdapter i wykonanie kwerendy.
Aby utworzyć instrukcję SQL zwracanie pojedynczej wartości, przy użyciu TableAdapter
Otwórz element dataset w Projektant Dataset.Aby uzyskać więcej informacji, zobacz Porady: otwieranie zestawu w narzędziu Projektant obiektów Dataset.
Jeśli nie masz już jeden utworzyć TableAdapter.Aby uzyskać więcej informacji na temat tworzenia TableAdapters, zobacz Porady: tworzenie TableAdapters.
Jeśli masz już kwerendę na swoje TableAdapter, używający instrukcji SQL w celu zwrócenia wartości pojedynczego, następnie przejdź do następnej procedury, "Aby"zadeklarować wystąpienie TableAdapter i wykonanie kwerendy. W przeciwnym razie przejdź do kroku 4, aby utworzyć nową kwerendę, która zwraca pojedynczą wartość.
Kliknij prawym przyciskiem myszy TableAdapter, który ma i dodać kwerendę za pomocą menu skrótów.
Kreatora konfiguracji kwerendy TableAdapter otwiera.
Pozostaw wartość domyślną z instrukcji SQL wykorzystania, a następnie kliknij przycisk Dalej.
Wybierz Wybierz, która zwraca pojedynczą wartość opcji, a następnie kliknij przycisk Dalej.
Wpisz swoją instrukcję SQL lub za pomocą Konstruktora kwerend ułatwiającego tworzenie jednego, a następnie kliknij przycisk Dalej.
Podaj nazwę dla tej kwerendy.
Zakończ pracę Kreatora; Kwerenda jest dodawana do TableAdapter.
Budowanie projektu.
Aby zadeklarować wystąpienie TableAdapter i wykonanie kwerendy
Stwierdzenie wystąpienie TableAdapter, który zawiera kwerendę, którą chcesz wykonać.
Aby utworzyć wystąpienie przy użyciu narzędzia projektowania, przeciągnij TableAdapter, który z Przybornik.(Składniki w projekcie są teraz wyświetlane w Przybornik pod nagłówkiem, który odpowiada nazwie użytkownika projektu.) Jeśli TableAdapter nie są wyświetlane w Przybornik, a następnie trzeba tworzyć projekty.
- lub -
Aby utworzyć wystąpienie w kodzie, zamień następujący kod z nazwy użytkownika DataSet i TableAdapter.
Dim tableAdapter As New DataSetTableAdapters.TableAdapter
[!UWAGA]
Faktycznie TableAdapters nie znajdują się wewnątrz ich klas skojarzonych dataset.Każdy zestaw danych ma odpowiedni zbiór TableAdapters w swoich własnych nazw.Na przykład, jeśli masz dataset, o nazwie SalesDataSet, a następnie byłoby SalesDataSetTableAdapters obszaru nazw, który zawiera jej TableAdapters.
Wywołanie kwerendy, jak możesz wywołać inną metodą w kodzie.Kwerenda jest metoda na TableAdapter.Zamień następujący kod o nazwach TableAdapter i kwerendy.Ponadto trzeba przekazać w wszelkie parametry wymagane przez kwerendę i zrobić coś z wartością zwróconą (na przykład przypisać ją do zmiennej).Jeśli nie jesteś pewien, jeśli kwerenda wymaga parametrów, lub parametry, jakich wymaga on następnie sprawdź IntelliSense wymagany podpis kwerendy.W zależności od tego, czy kwerenda pobiera parametry, lub nie kod wyglądałby podobny do jednego z następujących przykładów:
TableAdapter.Query()
TableAdapter.Query(Parameters)
Prawdopodobnie będzie trzeba przypisać wartości zwracanych przez kwerendę do zmiennej.Kwerendy TableAdapter, zwracających pojedynczą wartość zwracają typ danych, na podstawie kwerendy (w przeciwieństwie do ExecuteScalar metodę, która zwraca obiekt).Na przykład jeśli kwerenda TableAdapter wybiera pojedynczej kolumny, której typem danych jest liczbą całkowitą, wartość zwracana przez kwerendę jest liczbą całkowitą.Jeśli w kolumnie dozwolone są wartości null, wartość zwracana jest jednym z typów NULL (na przykład, Nullable(Of Integer)).Aby uzyskać więcej informacji na temat typów nullable, zobacz Nullable.Kompletny kod deklaruje instancję TableAdapter i wykonać kwerendę powinno wyglądać podobnie do następujących (w tym przykładzie zakłada zwracana wartość jest liczbą całkowitą; Dopasuj kod zgodnie z typem danych zwracanych przez kwerendę):
Dim tableAdapter As New NorthwindDataSetTableAdapters.CustomersTableAdapter() Dim returnValue As Integer returnValue = CType(tableAdapter.GetCustomerCount(), Integer)NorthwindDataSetTableAdapters.CustomersTableAdapter tableAdapter = new NorthwindDataSetTableAdapters.CustomersTableAdapter(); int returnValue = (int)tableAdapter.GetCustomerCount();
Wykonywanie instrukcji SQL, których zwrotu pojedynczej wartości za pomocą obiektu polecenie
Poniższy przykład pokazuje, jak utworzyć polecenie i wykonać instrukcję SQL, która zwraca jedną wartość.Aby uzyskać informacje na ustawianie i pobieranie wartości parametrów dla polecenia, zobacz Porady: ustawianie i pobieranie parametrów dla obiektów poleceń.
W tym przykładzie użyto SqlCommand obiektu i wymaga:
Odniesienia do System, System.Data, i System.Xml obszarów nazw.
Połączenie danych o nazwie SqlConnection1.
Tabela o nazwie Customers w danych źródła SqlConnection1 łączy.(W przeciwnym razie należy prawidłową instrukcję SQL dla źródła danych).
Aby wykonać instrukcję SQL zwracanie pojedynczej wartości, przy użyciu DataCommand
Dodaj następujący kod do metody, którą chcesz wykonać kod z.Zwraca jedną wartość, wywołując ExecuteScalar metoda polecenia (na przykład, ExecuteScalar).Dane są zwracane w Object.
Dim sqlConnection1 As New SqlConnection("Your Connection String") Dim cmd As New SqlCommand Dim returnValue As Object cmd.CommandText = "SELECT COUNT(*) FROM Customers" cmd.CommandType = CommandType.Text cmd.Connection = sqlConnection1 sqlConnection1.Open() returnValue = cmd.ExecuteScalar() sqlConnection1.Close()SqlConnection sqlConnection1 = new SqlConnection("Your Connection String"); SqlCommand cmd = new SqlCommand(); Object returnValue; cmd.CommandText = "SELECT COUNT(*) FROM Customers"; cmd.CommandType = CommandType.Text; cmd.Connection = sqlConnection1; sqlConnection1.Open(); returnValue = cmd.ExecuteScalar(); sqlConnection1.Close();
Zabezpieczenia
Aplikacja wymaga uprawnień do dostępu do bazy danych i wykonywanie instrukcji SQL.
Zobacz też
Zadania
Porady: tworzenie zapytań TableAdapter
Porady: edytowanie zapytań TableAdapter
Porady: wypełnianie zestawu danych danymi
Porady: ustawianie i pobieranie parametrów dla obiektów poleceń