ObjectDataSourceView.Update(IDictionary, IDictionary, IDictionary) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Выполняет операцию обновления путем вызова метода, заданного свойством UpdateMethod, используя при этом все параметры, предоставленные в коллекциях keys
, values
или oldValues
.
public:
int Update(System::Collections::IDictionary ^ keys, System::Collections::IDictionary ^ values, System::Collections::IDictionary ^ oldValues);
public int Update (System.Collections.IDictionary keys, System.Collections.IDictionary values, System.Collections.IDictionary oldValues);
override this.Update : System.Collections.IDictionary * System.Collections.IDictionary * System.Collections.IDictionary -> int
Public Function Update (keys As IDictionary, values As IDictionary, oldValues As IDictionary) As Integer
Параметры
- keys
- IDictionary
Коллекция IDictionary значений ключей, используемых для определения подлежащих обновлению элементов. Эти параметры используются совместно с методом, заданным свойством UpdateMethod для выполнения операции обновления. Если с методом не связан ни один параметр, возвращается значение null
.
- values
- IDictionary
Коллекция IDictionary новых значений, применяемая к источнику данных. Эти параметры используются совместно с методом, заданным свойством UpdateMethod для выполнения операции обновления базы данных. Если с методом не связан ни один параметр, возвращается значение null
.
- oldValues
- IDictionary
Коллекция IDictionary, содержащая дополнительные, не являющиеся ключами значения, используемые для сопоставления с элементом в источнике данных. Значения строки передаются методу удаления, только если в качестве значения свойства ConflictDetection задано поле CompareAllValues.
Возвращаемое значение
Число подлежащих обновлению строк; в противном случае — значение -1, если число неизвестно.
Комментарии
Возвращаемое значение по умолчанию равно -1, что означает, что было обновлено неизвестное количество строк. Чтобы вернуть другое значение, задайте AffectedRows свойство ObjectDataSourceStatusEventArgs объекта Updated события. Количество затронутых строк обычно возвращается методом Update
для бизнес-объекта, и это значение доступно из ReturnValue свойства ObjectDataSourceStatusEventArgs параметра Updated события.
Метод Update вызывает ExecuteUpdate метод , передавая keys
параметры , values
и oldValues
.