ObjectDataSourceView.ExecuteUpdate(IDictionary, IDictionary, IDictionary) ObjectDataSourceView.ExecuteUpdate(IDictionary, IDictionary, IDictionary) ObjectDataSourceView.ExecuteUpdate(IDictionary, IDictionary, IDictionary) ObjectDataSourceView.ExecuteUpdate(IDictionary, IDictionary, IDictionary) Method

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.Performs an update operation by calling the method that is identified by the UpdateMethod property and using any parameters that are supplied in the keys, values, or oldValues collections.

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 IDictionary IDictionary IDictionary

Un oggetto IDictionary di chiavi primarie da utilizzare con la proprietà UpdateMethod per eseguire l'operazione di aggiornamento sul database.A IDictionary of primary keys to use with the UpdateMethod property to perform the update database operation. Se non esistono chiavi associate al metodo, passare null.If there are no keys associated with the method, pass null.

values
IDictionary IDictionary IDictionary IDictionary

Un oggetto IDictionary di valori da utilizzare con la proprietà UpdateMethod per eseguire l'operazione di aggiornamento sul database.A IDictionary of values to be used with the UpdateMethod to perform the update database operation. Se non esistono parametri associati al metodo, passare null.If there are no parameters associated with the method, pass null.

oldValues
IDictionary IDictionary IDictionary IDictionary

Un oggetto IDictionary che rappresenta i valori originali nell'archivio dati sottostante.A IDictionary that represents the original values in the underlying data store. Se non esistono parametri associati alla query, passare null.If there are no parameters associated with the query, pass null.

Restituisce

Numero di righe aggiornate; oppure -1, se il numero non è noto.The number of rows updated; or -1, if the number is not known. Per ulteriori informazioni, vedere Update().For more information, see Update().

Eccezioni

Commenti

La ObjectDataSourceView classe implementa il metodo ExecuteUpdate ereditato per aggiornare i dati utilizzando un oggetto business.The ObjectDataSourceView class implements the inherited ExecuteUpdate method to update data using a business object. Gli sviluppatori di pagine e gli autori di controlli con associazione a ExecuteUpdate dati non chiamano direttamente il metodo; usare invece Update il metodo esposto pubblicamente.Page developers and data-bound control authors do not call the ExecuteUpdate method directly; instead, use the publicly exposed Update method.

I valori contenuti nelle keys raccolte e values vengono valutati e Uniti con tutti i valori contenuti UpdateParameters nella raccolta.The values that are contained in the keys and values collections are evaluated and merged with any values that are contained by the UpdateParameters collection. Se la ConflictDetection proprietà è impostata CompareAllValues sul valore, i valori contenuti nella oldValues raccolta vengono formattati con la OldValuesParameterFormatString proprietà e vengono uniti anche.If the ConflictDetection property is set to the CompareAllValues value, the values that are contained in the oldValues collection are formatted with the OldValuesParameterFormatString property and are also merged.

Prima di eseguire l'operazione di aggiornamento, OnUpdating viene chiamato il metodo per generare Updating l'evento.Before the update operation is performed, the OnUpdating method is called to raise the Updating event. È possibile gestire questo evento per esaminare i valori dei parametri e per eseguire qualsiasi pre-elaborazione prima di un aggiornamento.You can handle this event to examine the values of the parameters and to perform any preprocessing before an update. Per eseguire un'operazione di aggiornamento, ObjectDataSourceView usa la reflection per chiamare il metodo identificato UpdateMethod dalla proprietà e keys tutti i parametri associati nella raccolta e quindi li esegue.To perform an update operation, the ObjectDataSourceView uses reflection to call the method that is identified by the UpdateMethod property and any associated parameters in the keys collection, and then executes it. Al termine dell'operazione, viene chiamato OnUpdated il metodo per generare l' Updated evento.After the operation completes, the OnUpdated method is called to raise the Updated event. È possibile gestire questo evento per esaminare i valori restituiti, i codici di errore ed eseguire qualsiasi post-elaborazione.You can handle this event to examine any return values, error codes, and perform any post-processing.

Per ulteriori informazioni sulla restituzione del numero di righe aggiornate, Updatevedere.For more information on returning the number of rows updated, see Update.

Si applica a

Vedi anche