DataSourceView.ExecuteUpdate(IDictionary, IDictionary, IDictionary) Метод

Ссылка

Определение

Пространство имен:: System.Web.UI

Сборка:: System.Web.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Выполняет операцию обновления по списку данных, представляющем объект DataSourceView.

protected:
 virtual int ExecuteUpdate(System::Collections::IDictionary ^ keys, System::Collections::IDictionary ^ values, System::Collections::IDictionary ^ oldValues);

protected virtual int ExecuteUpdate (System.Collections.IDictionary keys, System.Collections.IDictionary values, System.Collections.IDictionary oldValues);

abstract member ExecuteUpdate : System.Collections.IDictionary * System.Collections.IDictionary * System.Collections.IDictionary -> int
override this.ExecuteUpdate : System.Collections.IDictionary * System.Collections.IDictionary * System.Collections.IDictionary -> int

Protected Overridable Function ExecuteUpdate (keys As IDictionary, values As IDictionary, oldValues As IDictionary) As Integer

Параметры

keys: IDictionary

IDictionary объекта или ключи строк для обновления с помощью операции обновления.

values: IDictionary

IDictionary пар имя-значение, представляющих элементы данных и их новые значения.

oldValues: IDictionary

IDictionary пар имя-значение, представляющих элементы данных и их исходные значения.

Возвращаемое значение

Int32

Количество элементов, обновленных в хранилище базовых данных.

Исключения

NotSupportedException

Операция ExecuteUpdate(IDictionary, IDictionary, IDictionary) не поддерживается DataSourceView.

Примеры

В следующем примере кода показано, как класс, расширяющий DataSourceView класс, может переопределить CanUpdate свойство и ExecuteUpdate метод. Этот пример кода является частью более крупного примера, предоставленного DataSourceView для класса.

// The CsvDataSourceView does not currently
// permit update operations. You can modify or
// extend this sample to do so.
public override bool CanUpdate {
    get {
        return false;
    }
}
protected override int ExecuteUpdate(IDictionary keys, IDictionary values, IDictionary oldValues)
{
    throw new NotSupportedException();
}

   ' The CsvDataSourceView does not currently
   ' permit update operations. You can modify or
   ' extend this sample to do so.
   Public Overrides ReadOnly Property CanUpdate() As Boolean
      Get
         Return False
      End Get
   End Property

   Protected Overrides Function ExecuteUpdate(keys As IDictionary, _
                                              values As IDictionary, _
                                              oldValues As IDictionary) As Integer
      Throw New NotSupportedException()
   End Function 'ExecuteUpdate

End Class

Элементы управления с привязкой к данным могут определить, поддерживается ли ExecuteUpdate операция элементом управления источником данных с помощью DataSourceControl.GetView метода для получения DataSourceView объекта и проверки значения CanUpdate свойства.

Параметр keys представляет объект или ключи строк обновляемых данных. Для источников данных, представляющих реляционные данные, такие как SqlDataSource элемент управления, keys параметр является коллекцией первичных ключей базы данных. В других сценариях keys параметр представляет собой коллекцию пар "имя-значение" и используется для фильтрации списка данных. Все данные, соответствующие паре "имя-значение", обновляются со значениями, найденными в параметре values , который представляет новые значения для существующих полей или столбцов.

Примечание

Реализация DataSourceView класса по умолчанию заключается в создании NotSupportedException исключения. При расширении DataSourceView класса переопределите ExecuteUpdate метод, если класс поддерживает обновление данных в базовом хранилище данных.

Применяется к

См. также раздел

CanUpdate