ObjectDataSourceView.Insert(IDictionary) Metoda

Definicja

Wykonuje operację wstawiania, wywołując metodę obiektu biznesowego, która jest identyfikowana przez InsertMethod Właściwość przy użyciu określonej values kolekcji.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

Parametry

values
IDictionary

IDictionaryKolekcja parametrów używana z InsertMethod właściwością do wykonania operacji wstawiania.A IDictionary collection of parameters used with the InsertMethod property to perform the insert operation. Jeśli z metodą nie są skojarzone żadne parametry, należy przekazać polecenie null .If there are no parameters associated with the method, pass null.

Zwraca

Int32

Liczba wstawionych wierszy; w przeciwnym razie,-1, jeśli liczba jest nieznana.The number of rows inserted; otherwise, -1, if the number is not known.

Wyjątki

CanInsertWłaściwość zwraca wartość false .The CanInsert property returns false.

Uwagi

Domyślna wartość zwracana to-1, co oznacza, że wstawiono nieznaną liczbę wierszy.The default return value is -1, which means that an unknown number of rows were inserted. Aby zwrócić inną wartość, należy ustawić AffectedRows Właściwość ObjectDataSourceStatusEventArgs obiektu Inserted zdarzenia.To return a different value, set the AffectedRows property of the ObjectDataSourceStatusEventArgs object of the Inserted event. Liczba objętych wierszy jest zwykle zwracana przez Insert metodę dla obiektu biznesowego, a ta wartość jest dostępna z ReturnValue właściwości ObjectDataSourceStatusEventArgs obiektu Inserted zdarzenia.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.

InsertMetoda wywołuje ExecuteInsert metodę, przekazując values kolekcję.The Insert method calls the ExecuteInsert method, passing the values collection.

Dotyczy

Zobacz też