ObjectDataSourceView.Update(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.

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 значений ключей, используемых для определения подлежащих обновлению элементов.A IDictionary of the key values used to identify the item to update. Эти параметры используются совместно с методом, заданным свойством UpdateMethod для выполнения операции обновления.These parameters are used with the method specified by the UpdateMethod property to perform the update operation. Если с методом не связан ни один параметр, возвращается значение null.If there are no parameters associated with the method, pass null.

values
IDictionary

Коллекция IDictionary новых значений, применяемая к источнику данных.A IDictionary of new values to apply to the data source. Эти параметры используются совместно с методом, заданным свойством UpdateMethod для выполнения операции обновления базы данных.These parameters are used with the method specified by the UpdateMethod property to perform the update database operation. Если с методом не связан ни один параметр, возвращается значение null.If there are no parameters associated with the method, pass null.

oldValues
IDictionary

Коллекция IDictionary, содержащая дополнительные, не являющиеся ключами значения, используемые для сопоставления с элементом в источнике данных.A IDictionary that contains the additional non-key values used to match the item in the data source. Значения строки передаются методу удаления, только если в качестве значения свойства ConflictDetection задано поле CompareAllValues.Row values are passed to the delete method, only if the ConflictDetection property is set to the CompareAllValues field.

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

Int32

Число подлежащих обновлению строк; в противном случае — значение -1, если число неизвестно.The number of rows updated; otherwise, -1, if the number is not known.

Комментарии

По умолчанию возвращается значение-1, означающее, что было обновлено неизвестное число строк.The default return value is -1, which means that an unknown number of rows were updated. Чтобы вернуть другое значение, задайте AffectedRows свойство ObjectDataSourceStatusEventArgs объекта Updated события.To return a different value, set the AffectedRows property of the ObjectDataSourceStatusEventArgs object of the Updated event. Количество затронутых строк обычно возвращается Update методом для бизнес-объекта, и это значение доступно в ReturnValue свойстве ObjectDataSourceStatusEventArgs параметра Updated события.The number of affected rows is typically returned by the Update method for the business object, and that value is available from the ReturnValue property of the ObjectDataSourceStatusEventArgs parameter of the Updated event.

UpdateМетод вызывает ExecuteUpdate метод, передавая keys values Параметры, и oldValues .The Update method calls the ExecuteUpdate method, passing the keys, values, and oldValues parameters.

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

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