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 business identificato dalla proprietà InsertMethod utilizzando l'insieme values specificato.
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 utilizzato con la proprietà InsertMethod per eseguire l'operazione di inserimento. Se non esistono parametri associati al metodo, passare null.
Restituisce
Numero di righe inserite; in caso contrario, -1, se il numero non è noto. Per altre informazioni, vedere Insert.
Eccezioni
La proprietà CanInsert restituisce false.
values è null o vuoto.
Commenti
La ObjectDataSourceView classe implementa il metodo ereditato per inserire i dati in un archivio dati sottostante ExecuteInsert usando un oggetto business. Gli sviluppatori di pagine e gli autori di controlli associati ai dati non chiamano direttamente il metodo. Usare invece il ExecuteInsert metodo esposto Insert pubblicamente.
Prima di eseguire l'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 ObjectDataSourceView controllo usa la reflection per chiamare il metodo identificato dalla InsertMethod proprietà e tutti i parametri associati presenti nell'insieme values e quindi lo esegue. Al termine dell'operazione, il OnInserted metodo viene chiamato 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.
