Практическое руководство. Создание и выполнение инструкций SQL, возвращающих строки

Статья
08/11/2011

Чтобы выполнить инструкцию SQL, возвращающую строки, можно запустить запрос адаптера таблицы, настроенный для выполнения инструкции SQL (например CustomersTableAdapter.Fill(CustomersDataTable)).

Если приложение не использует адаптеры таблиц, вызовите метод ExecuteReader объекта команды, присвоив его свойству CommandType значение Text. ("Объектом команды" называется определенная команда для поставщика данных платформы .NET Framework, используемого приложением. Например, если приложение использует поставщик данных платформы .NET Framework для SQL Server, объектом команды будет SqlCommand.)

В следующих примерах показано, как с помощью адаптеров таблиц или объектов команд выполнить инструкции SQL, возвращающие строки из базы данных. Дополнительные сведения о запросах с использованием адаптеров таблиц и команд содержатся в разделе Заполнение набора данных.

Выполнение возвращающих строки инструкций SQL с помощью адаптера таблицы

В этом примере показано создание запроса адаптера таблицы с помощью мастер настройки запроса TableAdapter, а также приводятся сведения об объявлении экземпляра адаптера таблицы и выполнении запроса.

Примечание

Отображаемые диалоговые окна и команды меню могут отличаться от описанных в справке в зависимости от текущих настроек или выпуска.Чтобы изменить параметры, выберите в меню Сервис пункт Импорт и экспорт параметров.Дополнительные сведения см. в разделе Работа с параметрами.

Чтобы создать возвращающую строки инструкцию SQL с помощью адаптера таблицы

Откройте набор данных в Конструкторе наборов данных. Дополнительные сведения см. в разделе Практическое руководство. Открытие набора данных в конструкторе наборов данных.
Создайте адаптер таблиц, если не сделали этого ранее. Дополнительные сведения о создании адаптеров таблиц см. в разделе Практическое руководство. Создание адаптера таблицы.
Если запрос на адаптер таблицы, использующий возвращающую строки инструкцию SQL, уже существует, перейдите к следующей процедуре "Чтобы объявить экземпляр Адаптера таблицы и выполнить запрос". В противном случае продолжите с шага 4, чтобы создать новый запрос, возвращающий строки.
Щелкните требуемый адаптер таблицы правой кнопкой мыши и используйте контекстное меню для добавления запроса.

Откроется Мастер настройки запроса адаптера таблиц.
Оставьте значение по умолчанию для элемента Использовать SQL инструкции и нажмите кнопку Далее.
Оставьте значение по умолчанию для элемента SELECT, возвращающий строки и нажмите кнопку Далее.
Введите инструкцию SQL или воспользуйтесь Построителем запросов для упрощения создания, затем нажмите кнопку Далее.
Введите имя для запроса.
Завершите работу мастера; запрос добавляется к адаптеру таблицы.
Построить проект.

Чтобы объявить экземпляр адаптера таблиц и выполнить запрос:

Объявите экземпляр адаптера таблиц, содержащий запрос, который требуется выполнить.
- Для создания экземпляра с помощью средств времени проектирования перетащите нужный адаптер таблиц из Панели элементов. (Компонент в проекте теперь отображается в Панели элементов под заголовком, совпадающим с именем проекта.) Если адаптер таблиц не отображается в Панели элементов, может потребоваться скомпилировать проект.
  
  – или –
- Чтобы создать экземпляр в коде, подставьте в следующий код имена DataSet и адаптера таблиц.
  
  Dim tableAdapter As New DataSetTableAdapters.TableAdapter
  
  Примечание
  
  Адаптеры таблиц на самом деле не располагаются внутри связанных с ними классов наборов данных.Каждый набор данных имеет соответствующую коллекцию адаптеров таблиц в своих собственных пространствах имен.Например, если имеется набор данных с именем SalesDataSet, то пространство имен SalesDataSetTableAdapters будет содержать его адаптеры таблиц.
Вызовите запрос, как вызвали бы любой другой метод в коде. Запрос представляет собой метод адаптера таблиц. Подставьте в следующий код имя адаптера таблиц и имя запроса. Кроме того, необходимо передать параметры, требуемые запросом. Если вы не уверены в том, что запросу необходимы параметры, и какие именно параметры требуются, то проверьте в IntelliSense требуемую сигнатуру запроса. В зависимости от того, принимает запрос параметры или нет, код будет выглядеть следующим образом:

TableAdapter.Query()

TableAdapter.Query(Parameters)

TableAdapter.Query(DataTable, Parameters)

Полный код объявления экземпляра адаптера таблицы и выполнения запроса должен выглядеть примерно следующим образом:

Dim tableAdapter As New NorthwindDataSetTableAdapters.CustomersTableAdapter()
tableAdapter.FillByCity(NorthwindDataSet.Customers, "Seattle")

NorthwindDataSetTableAdapters.CustomersTableAdapter tableAdapter = 
    new NorthwindDataSetTableAdapters.CustomersTableAdapter();

tableAdapter.FillByCity(northwindDataSet.Customers, "Seattle");

Выполнение возвращающих строки инструкций SQL с помощью объекта команд

В следующем примере демонстрируется способ создания команды и выполнения инструкции SQL, возвращающей строки. Сведения об установке и получении значений параметров для команды см. в разделе Практическое руководство. Установка и получение параметров командных объектов.

Этот пример использует объект SqlCommand и требует:

Ссылки на пространства имен System, System.Data, System.Data.SqlClient и System.Xml.
Подключение к данным с именем sqlConnection1.
Таблицу с именем Customers в источнике данных, к которому подключается sqlConnection1. (В противном случае необходима допустимая инструкция SQL для источника данных).

Для выполнения возвращающей строки инструкции SQL программными средствами с помощью объекта команды

Добавьте следующий код к методу, из которого он должен выполняться. Возвращайте строки, вызвав метод команды ExecuteReader (например ExecuteReader). Данные возвращаются в SqlDataReader. Дополнительные сведения о доступе к данным в SqlDataReader см. в разделе Извлечение данных с помощью DataReader (ADO.NET).

Dim sqlConnection1 As New SqlConnection("Your Connection String")
Dim cmd As New SqlCommand
Dim reader As SqlDataReader

cmd.CommandText = "SELECT * FROM Customers"
cmd.CommandType = CommandType.Text
cmd.Connection = sqlConnection1

sqlConnection1.Open()

reader = cmd.ExecuteReader()
' Data is accessible through the DataReader object here.

sqlConnection1.Close()

SqlConnection sqlConnection1 = new SqlConnection("Your Connection String");
SqlCommand cmd = new SqlCommand();
SqlDataReader reader;

cmd.CommandText = "SELECT * FROM Customers";
cmd.CommandType = CommandType.Text;
cmd.Connection = sqlConnection1;

sqlConnection1.Open();

reader = cmd.ExecuteReader();
// Data is accessible through the DataReader object here.

sqlConnection1.Close();