Установка и получение параметров объекта DataCommand

Если в приложении используется объект DataCommand, который работает непосредственно с элементами базы данных, то выполняемые SQL-запросы и хранимые процедуры обычно требуют параметров. Например, простая инструкция обновления записи — Update, требующая параметров, может иметь следующий вид:

UPDATE Employees

SET LastName=@LastName, FirstName=@FirstName, BirthDate=@BirthDate

WHERE (EmployeeID=@Emp_id)

Перед выполнением данного запроса, необходимо обязательно определить значения параметров (@LastName, @FirstName, @BirthDate и @Emp_id). Объект DataCommand поддерживают коллекцию Parameters, которая содержит набор объектов класса OleDbParameter или SqlParameter. Каждому параметру команды данных соответствует один объект в коллекции Parameters. Кроме того, если вызывается хранимая процедура, то возможно наличие дополнительного параметра, который будет принимать значение, возвращаемое процедурой.

Вы можете конфигурировать коллекцию Parameters Объекта DataCommand, используя окно свойств Properties или в программном коде. На рис. 3.2 показано окно редактора коллекции параметров, которое автоматически вызывается при нажатии кнопки в строке свойств Parametrs в окне Properties.

Примечание

Параметрам можно дать осмысленные имена, через которые можно обращаться к ним в программном коде. Хотя для ссылки на параметры можно использовать их индексные значения в коллекции Parameters, но программный код будет более ясным и понятным, если к параметрам обращаться с помощью имен.

Рис.51. Окно редактора коллекции параметров объекта DataCommand

Прежде, чем выполнять команду, необходимо установить значение для каждого параметра команды.

Для каждого параметра в коллекции Parameters задайте в свойстве Value то значение, которое нужно передать исполняемой команде. Следующий пример показывает, как установить значения параметров перед выполнением команды, которая вызывает хранимую процедуру. В данном примере предполагается, что вы уже сконфигурировали коллекцию Parameters (в коллекции содержится три параметра с менами au_id, аи_lname и au_fname). В данном примере такие свойства как CommandTex и CommandType задаются в программном коде, хотя они могут быть определены в окне Properties объекта DataCommand. Это сделано для большей наглядности и законченности приводимого в листинге программного кода.

Листинг

‘ Visual Basic

With OleDbCommand1

.CommandText="UpdateAuthor"

.CommandType=System.Data.CommandType.StoredProcedure

.Parameters("au_id").Value=listAuthorID.Text

.Parameters("au_lname").Value=txtAuthorLName.Text

.Parameters("au_fname").Value=txtAuthorFName.Text

End With

OleDbConnectionl.Open() OleDbCommandl.ExecuteNonQuery() OleDbConnectionl.Close()

// C#

OleDbCommandl.CommandText="UpdateAuthor";

OleDbCommandl.CommandType=System.Data.CommandType.StoredProcedure;

OleDbCommandl.Parameters["au_id"].-Value=listAuthorID.Text;

OleDbCommandl.Parameters["au_lname"].Value=txtAuthorLName.Text;

OleDbCommandl.Parameters["au_fname"].Value=txtAuthorFName.Text;

OleDbConnectionl.Open();

OleDbCommandl.ExecuteNonQuery();

OleDbConnectionl.Close ();

Дата добавления: 2014-11-20