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

Определение

Выполняет операцию обновления, используя SQL-строку UpdateCommand, все параметры, имеющиеся в коллекции UpdateParameters, и значения, содержащиеся в заданных коллекциях keys, values и oldValues.Performs an update operation using the UpdateCommand SQL string, any parameters that are in the UpdateParameters collection, and the values that are in the specified keys, values, and oldValues collections.

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 для выполнения операции обновления базы данных.An IDictionary of primary keys to use with the UpdateCommand property to perform the update database operation. Если с запросом не связан ни один ключ или если свойство UpdateCommand не является параметризованным SQL-запросом, передает значение null.If there are no keys associated with the query or if the UpdateCommand property is not a parameterized SQL query, pass null.

values
IDictionary

Объект IDictionary значений, используемых вместе со свойством UpdateCommand для выполнения операции обновления базы данных.An IDictionary of values to use with the UpdateCommand property to perform the update database operation. Если с запросом не связан ни один параметр или если свойство UpdateCommand не является параметризованным SQL-запросом, передает значение null.If there are no parameters associated with the query or if the UpdateCommand is not a parameterized SQL query, pass null.

oldValues
IDictionary

Объект IDictionary, предоставляющий исходные значения в базе данных.An IDictionary that represents the original values in the database. Если с запросом не связан ни один параметр или если свойство UpdateCommand не является параметризованным SQL-запросом, передает значение null.If there are no parameters associated with the query or if the UpdateCommand property is not a parameterized SQL query, pass null.

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

Значение, представляющее число строк, обновленных в основной базе данных.A value that represents the number of rows updated in the underlying database.

Исключения

Объекту SqlDataSource не удается установить подключение к базовому источнику данных.The SqlDataSource cannot establish a connection with the underlying data source.

- или --or- Свойству ConflictDetection присвоено значение CompareAllValues без передачи параметра oldValues.The ConflictDetection property is set to the CompareAllValues value and no oldValues parameters are passed.

У текущего пользователя нет надлежащих прав для получения доступа к базе данных.The current user does not have the correct permissions to gain access to the database.

Значение свойства CanUpdatefalse.The CanUpdate property is false.

Комментарии

Класс реализует наследуемый ExecuteUpdate метод для обновления данных в базе данных. SqlDataSourceViewThe SqlDataSourceView class implements the inherited ExecuteUpdate method to update data in a database. Разработчики страниц и элементы управления с привязкой к данным не вызывают ExecuteUpdate метод напрямую; вместо этого используйте Update общедоступный метод.Page developers and data-bound control authors do not call the ExecuteUpdate method directly; instead, use the publicly exposed Update method.

Значения, keys содержащиеся в коллекциях и values , вычисляются и объединяются с UpdateParameters любыми значениями, содержащимися в коллекции.The values contained in the keys and values collections are evaluated and merged with any values contained by the UpdateParameters collection. Если свойство имеет CompareAllValuesзначение, значения, содержащиеся в oldValues коллекции, форматируются с помощью OldValuesParameterFormatString , а также объединяются. ConflictDetectionIf the ConflictDetection property is set to CompareAllValues, the values contained in the oldValues collection are formatted with the OldValuesParameterFormatString and also merged.

Перед выполнением операции OnUpdating обновления вызывается метод для Updating вызова события.Before the update operation is performed, the OnUpdating method is called to raise the Updating event. Это событие можно обработать для проверки значений параметров и выполнения предварительной обработки перед обновлением.You can handle this event to examine the values of the parameters and perform any preprocessing before an update.

Чтобы выполнить эту операцию, SqlDataSourceView объект DbCommand выполняет сборку объекта, используя UpdateCommand текст и все DbCommand связанные UpdateParameters свойства, а затем выполняет объект в базовой базе данных.To perform the operation, the SqlDataSourceView builds a DbCommand object using the UpdateCommand text and any associated UpdateParameters properties, and then executes the DbCommand object against the underlying database. После завершения OnUpdated операции вызывается метод для Updated вызова события.After the operation completes, the OnUpdated method is called to raise the Updated event. Это событие можно обработать для проверки любых возвращаемых значений и кодов ошибок, а также для выполнения любой последующей обработки.You can handle this event to examine any return values and error codes and to perform any post-processing.

Применяется к

Дополнительно