Condividi tramite


ObjectDataSourceView.ExecuteUpdate Metodo

Definizione

Esegue un'operazione di aggiornamento chiamando il metodo identificato dalla proprietà UpdateMethod e utilizzando tutti i parametri forniti negli insiemi keys, values o 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 -> int
Protected Overrides Function ExecuteUpdate (keys As IDictionary, values As IDictionary, oldValues As IDictionary) As Integer

Parametri

keys
IDictionary

Un oggetto IDictionary di chiavi primarie da utilizzare con la proprietà UpdateMethod per eseguire l'operazione di aggiornamento sul database. Se non esistono chiavi associate al metodo, passare null.

values
IDictionary

Un oggetto IDictionary di valori da utilizzare con la proprietà UpdateMethod per eseguire l'operazione di aggiornamento sul database. Se non esistono parametri associati al metodo, passare null.

oldValues
IDictionary

Un oggetto IDictionary che rappresenta i valori originali nell'archivio dati sottostante. Se non esistono parametri associati alla query, passare null.

Restituisce

Numero di righe aggiornate; oppure -1, se il numero non è noto. Per altre informazioni, vedere Update().

Eccezioni

La proprietà CanInsert restituisce false.

oldValues è null o vuoto e 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 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 dall'insieme UpdateParameters . Se la ConflictDetection proprietà è impostata sul CompareAllValues valore, i valori contenuti nella oldValues raccolta 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, il ObjectDataSourceView metodo usa la reflection per chiamare il metodo identificato dalla UpdateMethod proprietà e tutti i parametri associati nella keys raccolta e quindi lo esegue. Al termine dell'operazione, il OnUpdated metodo viene chiamato 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.

Si applica a

Vedi anche