Поделиться через


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

Обновлен: Ноябрь 2007

Для выполнения сохраненной процедуры, возвращающей одиночное значение, запускается запрос объекта TableAdapter, настроенный для запуска сохраненной процедуры (например CustomersTableAdapter.CustomerCount()).

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

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

37hwc7kt.alert_note(ru-ru,VS.90).gifПримечание.

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

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

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

Для выполнения сохраненной процедуры, возвращающей одиночное значение, с помощью адаптера таблиц:

  1. Откройте набор данных в Конструкторе наборов данных. Дополнительные сведения см. в разделе Практическое руководство. Открытие набора данных в конструкторе наборов данных.

  2. Создайте адаптер таблиц, если не сделали этого ранее. Дополнительные сведения о создании адаптеров таблиц см. в разделе Практическое руководство. Создание адаптера таблицы.

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

  4. Щелкните требуемый адаптер таблиц правой кнопкой мыши и используйте контекстное меню для добавления запроса.

    Откроется Мастер настройки запроса адаптера таблиц.

  5. Выберите Использовать существующую сохраненную процедуру и нажмите кнопку Далее.

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

  7. Выберите параметр Одиночное значение и нажмите кнопку Далее.

  8. Введите имя для запроса.

  9. Нажмите кнопку Далее или Готово, чтобы завершить работу мастера; запрос добавляется в адаптер таблиц.

  10. Скомпилируйте проект.

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

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

    • Для создания экземпляра с помощью средств времени проектирования перетащите нужный адаптер таблиц из Панели элементов. (Компонент в проекте теперь отображается в Панели элементов под заголовком, совпадающим с именем проекта.) Если адаптер таблиц не отображается в Панели элементов, может потребоваться скомпилировать проект.

      либо

    • Чтобы создать экземпляр в коде, подставьте в следующий код имена DataSet и адаптера таблиц.

      Dim tableAdapter As New DataSetTableAdapters.TableAdapter

      37hwc7kt.alert_note(ru-ru,VS.90).gifПримечание.

      Адаптеры таблиц на самом деле не располагаются внутри связанных с ними классов наборов данных. Каждый набор данных имеет соответствующую коллекцию адаптеров таблиц в своих собственных пространствах имен. Например, если у вас есть набор данных с именем SalesDataSet, то будет существовать пространство имен SalesDataSetTableAdapters, содержащее его адаптеры таблиц.

  2. Вызовите запрос, как вызвали бы любой другой метод в коде. Запрос представляет собой метод адаптера таблиц. Подставьте в следующий код имя адаптера таблиц и имя запроса. Кроме того, необходимо передать любые параметры, необходимые запросу. Если вы не уверены в том, что запросу необходимы параметры, и какие именно параметры требуются, то проверьте в IntelliSense требуемую сигнатуру запроса. В зависимости то того, принимает ли запрос параметры или нет, код будет выглядеть аналогично одному из следующих примеров:

    TableAdapter.Query()

    TableAdapter.Query(Parameters)

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

    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();
    

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

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

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

  • Ссылки на пространства имен System, System.Data и System.Xml.

  • Подключение к данным с именем SqlConnection1.

  • Таблицу с именем Customers в источнике данных, к которому подключается SqlConnection1. (В противном случае необходима допустимая инструкция SQL для источника данных).

Для выполнения сохраненной процедуры, возвращающей одиночное значение, с помощью DataCommand:

  • Добавьте следующий код к методу, из которого он должен выполняться. Одиночное значение возвращается путем вызова метода ExecuteScalar команды (например ExecuteScalar). Данные возвращаются в object.

    Dim sqlConnection1 As New SqlConnection("Your Connection String")
    Dim cmd As New SqlCommand
    Dim returnValue As Object
    
    cmd.CommandText = "StoredProcedureName"
    cmd.CommandType = CommandType.StoredProcedure
    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 = "StoredProcedureName";
    cmd.CommandType = CommandType. StoredProcedure;
    cmd.Connection = sqlConnection1;
    
    sqlConnection1.Open();
    
    returnValue = cmd.ExecuteScalar();
    
    sqlConnection1.Close();
    

См. также

Задачи

Практическое руководство. Создание запросов TableAdapter

Практическое руководство. Изменение запросов TableAdapter

Практическое руководство. Заполнение данными набора данных

Практическое руководство. Установка и получение параметров командных объектов

Основные понятия

Общие сведения о заполнении наборов данных и запросе данных

Ссылки

SqlCommand.ExecuteScalar

OleDbCommand.ExecuteScalar

OdbcCommand.ExecuteScalar

OracleCommand.ExecuteScalar