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

Определение

Выполняет операцию обновления путем вызова метода, заданного свойством UpdateMethod, используя при этом все параметры, предоставленные в коллекциях keys, values или oldValues.Performs an update operation by calling the method that is identified by the UpdateMethod property and using any parameters that are supplied in the keys, values, or 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 первичных ключей, используемых вместе со свойством UpdateMethod для выполнения операции обновления базы данных.A IDictionary of primary keys to use with the UpdateMethod property to perform the update database operation. Если с методом не связан ни один ключ, возвращается значение null.If there are no keys associated with the method, pass null.

values
IDictionary

Объект IDictionary значений, который следует использовать вместе со свойством UpdateMethod для выполнения операции обновления базы данных.A IDictionary of values to be used with the UpdateMethod to perform the update database operation. Если с методом не связан ни один параметр, возвращается значение null.If there are no parameters associated with the method, pass null.

oldValues
IDictionary

Объект IDictionary, предоставляющий исходные значения в базовом хранилище данных.A IDictionary that represents the original values in the underlying data store. Если с запросом не связан ни один параметр, возвращается значение null.If there are no parameters associated with the query, pass null.

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

Int32

Число подлежащих обновлению строк или -1, если число неизвестно.The number of rows updated; or -1, if the number is not known. Для получения дополнительной информации см. Update().For more information, see Update().

Исключения

Свойство CanInsert возвращает значение false.The CanInsert property returns false.

Значение параметра oldValues равно null или этот параметр пуст, а свойству ConflictDetection присвоено значение CompareAllValues.oldValues is null or empty and ConflictDetection is set to CompareAllValues.

Комментарии

ObjectDataSourceViewКласс реализует наследуемый ExecuteUpdate метод для обновления данных с помощью бизнес-объекта.The ObjectDataSourceView class implements the inherited ExecuteUpdate method to update data using a business object. Разработчики страниц и элементы управления с привязкой к данным не вызывают 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 that are contained in the keys and values collections are evaluated and merged with any values that are contained by the UpdateParameters collection. Если ConflictDetection свойству присвоено CompareAllValues значение, значения, содержащиеся в oldValues коллекции, форматируются с помощью OldValuesParameterFormatString Свойства и также объединяются.If the ConflictDetection property is set to the CompareAllValues value, the values that are contained in the oldValues collection are formatted with the OldValuesParameterFormatString property and are 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 to perform any preprocessing before an update. Для выполнения операции обновления ObjectDataSourceView компонент использует отражение для вызова метода, идентифицируемого UpdateMethod свойством, и всех связанных параметров в keys коллекции, а затем выполняет его.To perform an update operation, the ObjectDataSourceView uses reflection to call the method that is identified by the UpdateMethod property and any associated parameters in the keys collection, and then executes it. После завершения операции 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, error codes, and perform any post-processing.

Дополнительные сведения о возврате количества обновляемых строк см. в разделе Update .For more information on returning the number of rows updated, see Update.

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

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