1.4.7. Конфигурирование параметров объекта DataAdapter
В большинстве случаев команды адаптера данных (SelectCommand, InsertCommand, UpdateCommand И DeleteCommand) построены на основе SQL- запросов с параметрами. Если для создания объекта DataAdapter использовать мастер Data Adapter Configuration Wizard, то параметры для этих команд будут сконфигурированы автоматически. Однако вы можете сконфигурировать параметры вручную, или сделать необходимые изменения в уже существующей коллекции параметров.
Для конфигурации параметров объекта DataAdapter необходимо.
-
Создать объект DataAdapter.
2. В форме мышью выделить объект DataAdapter и открыть окно свойств Properties (рис. 1.26).
3. Раскройте объект Command, для которого вы хотите сконфигурировать параметры (например, UpdateCommand) и затем в свойстве Parameters нажмите кнопку, чтобы открыть окно SqlParameter Collection Editor (рис. 1.27).
-
Для создания нового параметра щелкните на кнопке Add.
-
Переместите новый параметр в нужное место коллекции, используя кнопки со стрелками для перемещения его вверх или вниз.
-
Чтобы установить требуемое свойства параметра, выберите его в списке Members и затем назначьте ему нужное свойство. В табл. 1.3. перечислены типовые свойства, которые вы можете установить.
Таблица 1.3. Свойства параметров объектов DataCommand адаптера данных
|
Свойство Описание |
|
|
SourceColumn |
Имя столбца в таблице набора данных, из которого будет читаться значение параметра. Это свойство используется с параметрами, которые заполняются значениями в запросах update, insert или delete (то же в хранимых процедурах) |
|
SourceVersion |
Если параметр получает значение из свойства SourceColumn, то SourceVersion определяет, какая версия записи набора данных будет использоваться, как источник значения параметра: |
|
□ Original — значение столбца, которое было получено из базы данных. Вы можете использовать данное значение тогда, когда вам необходимо иметь то значение столбца, которое было до его изменения. Например, было изменено значение ключевого поля, но вам необходимо иметь старое значение этого поля, чтобы найти нужную запись в базе данных |
|
|
□ Current — значение столбца после того, как запись была изменена. Это обычно то значение, которое будет записано в базу данных |
|
|
□ Default — значение, которое будет присвоено столбцу, если никакое другое значение явно не задано |
|
|
Value |
Значение, присвоенное параметру. Это свойство обычно устанавливается динамически (во время выполнения программы), а не статически во время ее разработки |
|
|
Свойство Value имеет приоритет по отношению к свойству SourceColumn, если они оба установлены |
|
NamedParameter |
Поименованный параметр. Булево значение, указывающее, что параметр является переменной с именем (@parametername) или меткой (?). Если вы работаете с объектом SqlConnection и используете поименованные параметры, то установите значение |
|
DBType, Precision, Scale, Size |
Информация о типе значения параметра (в источнике данных). Значение параметра будет конвертировано в тип данных, который вы определили, или из него |
|
Direction |
Указание направления: передается ли значение параметра к команде или от команды: |
|
|
• Input — значение передается к команде. Это значение установлено по умолчанию |
|
|
• Output — значение передается к хранимой процедуре (не используется с SQL-запросами) |
|
|
• InputOutput — значение передаются к хранимым процедурам и возвращаются назад, обычно в измененном виде |
|
|
• ReturnValue — явно возвращаемое значение. По умолчанию возвращаемое значение — первый элемент в коллекции параметров (с индексом 0) |
|
ParameterName |
Имя, по которому можно обратиться к параметру вместо его номера в коллекции. Для простоты последующего сопровождения приложения рекомендуется использовать имя параметра, а не его номер |
-
Нажмите кнопку ОК для закрытия окна SqlParameter Collection Editor.
-
Повторите шаги с 3-го по 7-й для задания конфигурации параметров других объектов Command.