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 name/value, представляющие элементы данных и их новые значения.

oldValues

IDictionary

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

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

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 параметр представляет собой коллекцию пар "имя-значение" и используется для фильтрации списка данных. Все данные, соответствующие паре name/value, обновляются со значениями, найденными в values параметре, который представляет собой набор пар name/value, представляющих новые значения для существующих полей или столбцов.

Замечание

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

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

• CanUpdate