ObjectDataSourceView.Insert(IDictionary) Метод

Определение

Выполняет операцию вставки путем вызова метода бизнес-объектов, заданного свойством InsertMethod, используя заданную коллекцию values.Performs an insert operation by calling the business object method that is identified by the InsertMethod property using the specified values collection.

public:
 int Insert(System::Collections::IDictionary ^ values);
public int Insert (System.Collections.IDictionary values);
override this.Insert : System.Collections.IDictionary -> int
Public Function Insert (values As IDictionary) As Integer

Параметры

values
IDictionary

Коллекция IDictionary параметров, используемый совместно со свойством InsertMethod для выполнения операции вставки.A IDictionary collection of parameters used with the InsertMethod property to perform the insert operation. Если с методом не связан ни один параметр, возвращается значение null.If there are no parameters associated with the method, pass null.

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

Int32

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

Исключения

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

Комментарии

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

InsertМетод вызывает ExecuteInsert метод, передавая values коллекцию.The Insert method calls the ExecuteInsert method, passing the values collection.

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

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