SqlDataSourceView.ExecuteInsert(IDictionary) Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Esegue un'operazione di inserimento utilizzando la stringa SQL InsertCommand, tutti i parametri specificati nell'insieme InsertParameters e i valori dell'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

Insieme IDictionary di valori utilizzati con la proprietà InsertCommand per eseguire l'operazione di inserimento del database. Se non sono presenti parametri associati alla query oppure se la proprietà InsertCommand non dispone di query SQL con parametri, viene passato null.

Restituisce

Int32

Valore che rappresenta il numero di righe inserite nel database sottostante.

Eccezioni

InvalidOperationException

L'oggetto SqlDataSource non può stabilire una connessione con l'origine dati sottostante.

HttpException

L'utente corrente non dispone delle autorizzazioni corrette per ottenere l'accesso al database.

NotSupportedException

La proprietà CanInsert è false.

Commenti

La SqlDataSourceView classe implementa il metodo ereditato ExecuteInsert per inserire dati in un database. Gli sviluppatori di pagine e gli autori di controlli associati a dati non chiamano direttamente il ExecuteInsert metodo, ma usano invece il metodo esposto Insert pubblicamente.

Prima di eseguire l'operazione di inserimento, viene chiamato il OnInserting metodo per generare l'evento Inserting . È possibile gestire questo evento per esaminare i valori dei parametri e per eseguire qualsiasi pre-elaborazione prima di un inserimento.

Per eseguire un'operazione di inserimento, l'oggetto SqlDataSourceView compila un DbCommand oggetto usando il InsertCommand testo e le proprietà associate InsertParameters e quindi esegue l'oggetto DbCommand sul database sottostante. Al termine dell'inserimento, viene chiamato il OnInserted metodo per generare l'evento Inserted . È possibile gestire questo evento per esaminare i valori restituiti e i codici di errore e per eseguire qualsiasi post-elaborazione.

Si applica a

Vedi anche