ObjectDataSourceView.ExecuteInsert(IDictionary) Metódus
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
Beszúrási műveletet hajt végre a tulajdonság által InsertMethod a megadott values gyűjtemény használatával azonosított üzleti objektum metódus meghívásával.
protected:
override int ExecuteInsert(System::Collections::IDictionary ^ values);
protected override int ExecuteInsert(System.Collections.IDictionary values);
override this.ExecuteInsert : System.Collections.IDictionary -> int
Protected Overrides Function ExecuteInsert (values As IDictionary) As Integer
Paraméterek
- values
- IDictionary
A IDictionary tulajdonsággal együtt InsertMethod használt paraméterek egyike a beszúrási művelet végrehajtásához. Ha a metódushoz nincsenek paraméterek társítva, adja át a elemet null.
Válaszok
A beszúrt sorok száma; ellenkező esetben -1, ha a szám nem ismert. További információért lásd Insert.
Kivételek
A CanInsert tulajdonság visszaadja a következőt false: .
values vagy null üres.
Megjegyzések
Az ObjectDataSourceView osztály implementálja az örökölt metódust ExecuteInsert , amely adatokat szúr be egy mögöttes adattárba egy üzleti objektum használatával. A lapfejlesztők és az adathoz kötött vezérlők nem hívják meg közvetlenül a ExecuteInsert metódust, hanem a nyilvánosan közzétett Insert metódust használják.
A beszúrás végrehajtása előtt a rendszer meghívja a OnInserting metódust az Inserting esemény felemelésére. Ezt az eseményt kezelheti a paraméterek értékeinek vizsgálatához, és a metódus meghívása előtt Insert bármilyen előfeldolgozást végrehajthat.
A beszúrási művelet végrehajtásához a ObjectDataSourceView vezérlő tükröződés használatával meghívja a tulajdonság és a InsertMethodvalues gyűjteményben található társított paraméterek által azonosított metódust, majd végrehajtja azt. A művelet befejezése után a rendszer meghívja a OnInserted metódust az Inserted esemény felemelésére. Ezt az eseményt kezelheti a visszatérési értékek, hibakódok vizsgálatához és a feldolgozás utáni műveletek végrehajtásához.
A beszúrt sorok számának visszaadásával kapcsolatos további információkért lásd: Insert.