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 usando la UpdateCommand stringa SQL, tutti i parametri presenti nella UpdateParameters raccolta e i valori presenti nelle raccolte , valuese oldValues specificatikeys.
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
Oggetto IDictionary delle chiavi primarie da utilizzare con la UpdateCommand proprietà per eseguire l'operazione di aggiornamento del database. Se alla query non sono associate chiavi o se la UpdateCommand proprietà non è una query SQL con parametri, passare null.
- values
- IDictionary
Oggetto IDictionary di valori da utilizzare con la UpdateCommand proprietà per eseguire l'operazione di aggiornamento del database. Se non sono presenti parametri associati alla query o se UpdateCommand non è una query SQL con parametri, passare null.
- oldValues
- IDictionary
Oggetto IDictionary che rappresenta i valori originali nel database. Se alla query non sono associati parametri o se la UpdateCommand proprietà non è una query SQL con parametri, passare null.
Restituisce
Valore che rappresenta il numero di righe aggiornate nel database sottostante.
Eccezioni
Impossibile SqlDataSource stabilire una connessione con l'origine dati sottostante.
oppure
La ConflictDetection proprietà è impostata sul CompareAllValues valore e non oldValues vengono passati parametri.
L'utente corrente non dispone delle autorizzazioni corrette per ottenere l'accesso al database.
La CanUpdate proprietà è 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 a dati non chiamano direttamente il ExecuteUpdate metodo. Usare invece il metodo esposto Update pubblicamente.
I valori contenuti nelle keys raccolte e values vengono valutati e uniti con tutti i valori contenuti nell'insieme UpdateParameters . Se la ConflictDetection proprietà è impostata su CompareAllValues, i valori contenuti nell'insieme oldValues vengono formattati con OldValuesParameterFormatString e 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, compila SqlDataSourceView un DbCommand oggetto utilizzando il UpdateCommand testo e le proprietà associate UpdateParameters e quindi esegue l'oggetto DbCommand sul database sottostante. Al termine dell'operazione, viene chiamato il OnUpdated metodo 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.
