ObjectDataSourceView.ExecuteUpdate Метод

Определение

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

System.Web.UI.WebControls

Сборка:

System.Web.dll

Выполняет операцию обновления путем вызова метода, заданного свойством UpdateMethod, используя при этом все параметры, предоставленные в коллекциях 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 первичных ключей, используемых вместе со свойством UpdateMethod для выполнения операции обновления базы данных. Если с методом не связан ни один ключ, возвращается значение null.

values

IDictionary

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

oldValues

IDictionary

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

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

Int32

Число подлежащих обновлению строк или -1, если число неизвестно. Для получения дополнительной информации см. Update().

Исключения

NotSupportedException

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

InvalidOperationException

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

Комментарии

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

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

Перед выполнением OnUpdating операции обновления вызывается метод для вызова Updating события . Это событие можно обработать для проверки значений параметров и выполнения любой предварительной обработки перед обновлением. Для выполнения операции обновления использует отражение для вызова метода, ObjectDataSourceView определяемого свойством UpdateMethod и любыми связанными параметрами keys в коллекции, а затем выполняет его. После завершения операции вызывается метод для OnUpdated вызова Updated события . Это событие можно обработать для проверки возвращаемых значений, кодов ошибок и выполнения постобработки.

Дополнительные сведения о возврате количества обновленных строк см. в разделе Update.

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

• Update(IDictionary, IDictionary, IDictionary)
• UpdateMethod
• UpdateParameters
• OnUpdating(ObjectDataSourceMethodEventArgs)
• OnUpdated(ObjectDataSourceStatusEventArgs)
• Updating
• Updated