ObjectDataSourceView.ExecuteUpdate(IDictionary, IDictionary, IDictionary) Metoda

Definicja

Wykonuje operację aktualizacji, wywołując metodę, która jest identyfikowana przez UpdateMethod Właściwość i korzystając z parametrów, które są podane w keys , values , lub oldValues kolekcje.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

Parametry

keys
IDictionary

IDictionaryKlucz podstawowy, który ma być używany z UpdateMethod właściwością do wykonania operacji aktualizacji bazy danych.A IDictionary of primary keys to use with the UpdateMethod property to perform the update database operation. Jeśli z metodą nie są skojarzone żadne klucze, należy przekazać polecenie null .If there are no keys associated with the method, pass null.

values
IDictionary

Wartość, IDictionary która ma zostać użyta w UpdateMethod celu wykonania operacji Update Database.A IDictionary of values to be used with the UpdateMethod to perform the update database operation. Jeśli z metodą nie są skojarzone żadne parametry, należy przekazać polecenie null .If there are no parameters associated with the method, pass null.

oldValues
IDictionary

IDictionaryReprezentuje oryginalne wartości w źródłowym magazynie danych.A IDictionary that represents the original values in the underlying data store. Jeśli nie ma żadnych parametrów skojarzonych z zapytaniem, Przekaż null .If there are no parameters associated with the query, pass null.

Zwraca

Int32

Liczba zaktualizowanych wierszy; lub-1, jeśli liczba jest nieznana.The number of rows updated; or -1, if the number is not known. Aby uzyskać więcej informacji, zobacz Update().For more information, see Update().

Wyjątki

CanInsertWłaściwość zwraca wartość false .The CanInsert property returns false.

oldValues jest null lub puste i ConflictDetection jest ustawione na CompareAllValues .oldValues is null or empty and ConflictDetection is set to CompareAllValues.

Uwagi

ObjectDataSourceViewKlasa implementuje dziedziczonej ExecuteUpdate metody do aktualizowania danych przy użyciu obiektu biznesowego.The ObjectDataSourceView class implements the inherited ExecuteUpdate method to update data using a business object. Deweloperzy stron i autorzy powiązanych danych nie wywołują ExecuteUpdate metody bezpośrednio; zamiast tego należy używać publicznie uwidocznionej Update metody.Page developers and data-bound control authors do not call the ExecuteUpdate method directly; instead, use the publicly exposed Update method.

Wartości, które znajdują się w keys values kolekcjach i są oceniane i scalane z wartościami zawartymi w UpdateParameters kolekcji.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. Jeśli ConflictDetection Właściwość jest ustawiona na CompareAllValues wartość, wartości, które są zawarte w oldValues kolekcji, są formatowane z OldValuesParameterFormatString właściwością i są również scalane.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.

Przed wykonaniem operacji aktualizacji OnUpdating Metoda jest wywoływana w celu podniesienia Updating zdarzenia.Before the update operation is performed, the OnUpdating method is called to raise the Updating event. Możesz obsłużyć to zdarzenie, aby przeanalizować wartości parametrów i wykonać wszelkie wstępne przetwarzanie przed aktualizacją.You can handle this event to examine the values of the parameters and to perform any preprocessing before an update. Aby wykonać operację aktualizacji, ObjectDataSourceView używa odbicia w celu wywołania metody, która jest identyfikowana przez UpdateMethod Właściwość i wszystkie skojarzone z nią parametry w keys kolekcji, a następnie wykonuje ją.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. Po zakończeniu operacji OnUpdated Metoda jest wywoływana w celu podniesienia Updated zdarzenia.After the operation completes, the OnUpdated method is called to raise the Updated event. Możesz obsłużyć to zdarzenie, aby przeanalizować wszelkie wartości zwracane przez kody błędów i wykonać wszelkie przetwarzanie końcowe.You can handle this event to examine any return values, error codes, and perform any post-processing.

Aby uzyskać więcej informacji na temat zwracania liczby zaktualizowanych wierszy, zobacz Update .For more information on returning the number of rows updated, see Update.

Dotyczy

Zobacz też