ObjectDataSourceView.ExecuteInsert(IDictionary) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Esegue un'operazione di inserimento chiamando il metodo dell'oggetto InsertMethod business identificato dalla proprietà utilizzando l'insieme specificato values .
protected:
override int ExecuteInsert(System::Collections::IDictionary ^ values);protected override int ExecuteInsert(System.Collections.IDictionary values);override this.ExecuteInsert : System.Collections.IDictionary -> intProtected Overrides Function ExecuteInsert (values As IDictionary) As IntegerParametri
- values
- IDictionary
Oggetto IDictionary di parametri utilizzati con la InsertMethod proprietà per eseguire l'operazione di inserimento. Se al metodo non sono associati parametri, passare null.
Restituisce
Numero di righe inserite; in caso contrario, -1, se il numero non è noto. Per altre informazioni, vedere Insert.
Eccezioni
La CanInsert proprietà restituisce false.
values è null o vuoto.
Commenti
La ObjectDataSourceView classe implementa il metodo ereditato ExecuteInsert per inserire dati in un archivio dati sottostante usando un oggetto business. Gli sviluppatori di pagine e gli autori di controlli associati a dati non chiamano direttamente il ExecuteInsert metodo. Usare invece il metodo esposto Insert pubblicamente.
Prima dell'esecuzione dell'inserimento, viene chiamato il OnInserting metodo per generare l'evento Inserting . È possibile gestire questo evento per esaminare i valori dei parametri ed eseguire qualsiasi pre-elaborazione prima che venga chiamato il Insert metodo .
Per eseguire un'operazione di inserimento, il controllo utilizza la ObjectDataSourceView reflection per chiamare il metodo identificato dalla InsertMethod proprietà ed eventuali parametri associati presenti nell'insieme values e quindi lo esegue. Al termine dell'operazione, viene chiamato il OnInserted metodo per generare l'evento Inserted . È possibile gestire questo evento per esaminare i valori restituiti, i codici di errore ed eseguire qualsiasi post-elaborazione.
Per altre informazioni sulla restituzione del numero di righe inserite, vedere Insert.
