Condividi tramite


ObjectDataSourceView.ExecuteInsert(IDictionary) Metodo

Definizione

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 -> int
Protected Overrides Function ExecuteInsert (values As IDictionary) As Integer

Parametri

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.

Si applica a

Vedi anche