SqlDataSourceView.ExecuteUpdate(IDictionary, IDictionary, 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 aggiornamento utilizzando la stringa SQL UpdateCommand tutti i parametri specificati nell'insieme UpdateParameters e i valori degli insiemi keys, values e oldValues specificati.
protected:
override int ExecuteUpdate(System::Collections::IDictionary ^ keys, System::Collections::IDictionary ^ values, System::Collections::IDictionary ^ oldValues);protected override int ExecuteUpdate (System.Collections.IDictionary keys, System.Collections.IDictionary values, System.Collections.IDictionary oldValues);override this.ExecuteUpdate : System.Collections.IDictionary * System.Collections.IDictionary * System.Collections.IDictionary -> intProtected Overrides Function ExecuteUpdate (keys As IDictionary, values As IDictionary, oldValues As IDictionary) As IntegerParametri
- keys
- IDictionary
Insieme IDictionary di chiavi primarie da utilizzare con la proprietà UpdateCommand per eseguire l'operazione di aggiornamento del database. Se non sono presenti chiavi associate alla query oppure se la proprietà UpdateCommand non dispone di query SQL con parametri, viene passato null.
- values
- IDictionary
Insieme IDictionary di valori da utilizzare con la proprietà UpdateCommand per eseguire l'operazione di aggiornamento del database. Se non sono presenti parametri associati alla query oppure se la proprietà UpdateCommand non dispone di query SQL con parametri, viene passato null.
- oldValues
- IDictionary
Insieme IDictionary che rappresenta i valori originali nel database. Se non sono presenti parametri associati alla query oppure se la proprietà UpdateCommand non dispone di query SQL con parametri, viene passato null.
Restituisce
Valore che rappresenta il numero di righe aggiornate nel database sottostante.
Eccezioni
L'oggetto SqlDataSource non può stabilire una connessione con l'origine dati sottostante.
-oppure-
La proprietà ConflictDetection è impostata sul valore CompareAllValues e non viene passato alcun parametro oldValues.
L'utente corrente non dispone delle autorizzazioni corrette per ottenere l'accesso al database.
La proprietà CanUpdate è false.
Commenti
La SqlDataSourceView classe implementa il metodo ereditato ExecuteUpdate per aggiornare i dati in un database. Gli sviluppatori di pagine e gli autori di controlli associati ai dati non chiamano direttamente il metodo. Usare invece il ExecuteUpdate metodo esposto Update pubblicamente.
I valori contenuti nelle keys raccolte e vengono valutati e values uniti a tutti i valori contenuti dalla UpdateParameters raccolta. Se la ConflictDetection proprietà è impostata su CompareAllValues, i valori contenuti nella oldValues raccolta vengono formattati con e OldValuesParameterFormatString uniti.
Prima di eseguire l'operazione di aggiornamento, viene chiamato il OnUpdating metodo per generare l'evento Updating . È possibile gestire questo evento per esaminare i valori dei parametri ed eseguire qualsiasi pre-elaborazione prima di un aggiornamento.
Per eseguire l'operazione, l'oggetto SqlDataSourceView compila un DbCommand oggetto usando il UpdateCommand testo e le proprietà associate UpdateParameters e quindi esegue l'oggetto DbCommand sul database sottostante. Al termine dell'operazione, il OnUpdated metodo viene chiamato per generare l'evento Updated . È possibile gestire questo evento per esaminare i valori restituiti e i codici di errore e per eseguire qualsiasi post-elaborazione.
