SqlDataSourceView.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 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 -> intProtected Overrides Function ExecuteInsert (values As IDictionary) As IntegerParametri
- 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
Valore che rappresenta il numero di righe inserite nel database sottostante.
Eccezioni
L'oggetto SqlDataSource non può stabilire una connessione con l'origine dati sottostante.
L'utente corrente non dispone delle autorizzazioni corrette per ottenere l'accesso al database.
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.
