ObjectDataSourceView.ExecuteUpdate 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 chiamando il metodo identificato dalla UpdateMethod proprietà e utilizzando tutti i parametri forniti nelle keysraccolte , valueso oldValues .
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 UpdateMethod proprietà per eseguire l'operazione di aggiornamento del database. Se al metodo non sono associate chiavi, passare null.
- values
- IDictionary
Oggetto IDictionary di valori da utilizzare con UpdateMethod per eseguire l'operazione di aggiornamento del database. Se al metodo non sono associati parametri, passare null.
- oldValues
- IDictionary
Oggetto IDictionary che rappresenta i valori originali nell'archivio dati sottostante. Se alla query non sono associati parametri, passare null.
Restituisce
Numero di righe aggiornate; o -1, se il numero non è noto. Per altre informazioni, vedere Update().
Eccezioni
La CanInsert proprietà restituisce false.
oldValues è null o vuoto ed ConflictDetection è impostato su CompareAllValues.
Commenti
La ObjectDataSourceView classe implementa il metodo ereditato ExecuteUpdate per aggiornare i dati usando un oggetto business. 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 sul CompareAllValues valore , i valori contenuti nell'insieme oldValues vengono formattati con la OldValuesParameterFormatString proprietà e vengono 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 e per eseguire qualsiasi pre-elaborazione prima di un aggiornamento. Per eseguire un'operazione di aggiornamento, usa la ObjectDataSourceView reflection per chiamare il metodo identificato dalla UpdateMethod proprietà ed eventuali parametri associati nella keys raccolta e quindi lo esegue. Al termine dell'operazione, viene chiamato il OnUpdated metodo per generare l'evento Updated . È 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 aggiornate, vedere Update.
