SqlDataSourceView.ExecuteUpdate(IDictionary, IDictionary, IDictionary) Метод

Определение

Пространство имен:

System.Web.UI.WebControls

Сборка:

System.Web.dll

Выполняет операцию обновления, используя SQL-строку UpdateCommand, все параметры, имеющиеся в коллекции UpdateParameters, и значения, содержащиеся в заданных коллекциях keys, values и oldValues.

protected:
 override int ExecuteUpdate(System::Collections::IDictionary ^ keys, System::Collections::IDictionary ^ values, System::Collections::IDictionary ^ oldValues);

protected override int ExecuteUpdate (System.Collections.IDictionary keys, System.Collections.IDictionary values, System.Collections.IDictionary oldValues);

override this.ExecuteUpdate : System.Collections.IDictionary * System.Collections.IDictionary * System.Collections.IDictionary -> int

Protected Overrides Function ExecuteUpdate (keys As IDictionary, values As IDictionary, oldValues As IDictionary) As Integer

Параметры

keys

IDictionary

Объект IDictionary первичных ключей, используемых вместе со свойством UpdateCommand для выполнения операции обновления базы данных. Если с запросом не связан ни один ключ или если свойство UpdateCommand не является параметризованным SQL-запросом, передает значение null.

values

IDictionary

Объект IDictionary значений, используемых вместе со свойством UpdateCommand для выполнения операции обновления базы данных. Если с запросом не связан ни один параметр или если свойство UpdateCommand не является параметризованным SQL-запросом, передает значение null.

oldValues

IDictionary

Объект IDictionary, предоставляющий исходные значения в базе данных. Если с запросом не связан ни один параметр или если свойство UpdateCommand не является параметризованным SQL-запросом, передает значение null.

Возвращаемое значение

Int32

Значение, представляющее число строк, обновленных в основной базе данных.

Исключения

InvalidOperationException

Объекту SqlDataSource не удается установить подключение к базовому источнику данных.

-или-

Свойству ConflictDetection присвоено значение CompareAllValues без передачи параметра oldValues.

HttpException

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

NotSupportedException

Значение свойства CanUpdate — false.

Комментарии

Класс SqlDataSourceView реализует наследуемый ExecuteUpdate метод для обновления данных в базе данных. Разработчики страниц и авторы элементов управления, привязанных к данным, не вызывают ExecuteUpdate метод напрямую. Вместо этого используйте открытый Update метод.

Значения, содержащиеся в коллекциях keys и values , вычисляются и объединяются со значениями, содержащимися в UpdateParameters коллекции. Если свойству ConflictDetection присвоено значение CompareAllValues, значения, содержащиеся в oldValues коллекции, форматируются с OldValuesParameterFormatString и также объединяются.

Перед выполнением OnUpdating операции обновления вызывается метод для вызова Updating события . Это событие можно обработать для проверки значений параметров и выполнения любой предварительной обработки перед обновлением.

Для выполнения операции SqlDataSourceView создается DbCommand объект с использованием UpdateCommand текста и всех связанных UpdateParameters свойств, а затем выполняет объект в DbCommand базовой базе данных. После завершения OnUpdated операции вызывается метод для вызова Updated события . Это событие можно обрабатывать для проверки любых возвращаемых значений и кодов ошибок, а также для выполнения любой последующей обработки.

См. также раздел

• Update(IDictionary, IDictionary, IDictionary)
• UpdateCommand
• UpdateParameters