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

Определение

Пространство имен:

System.Web.UI

Сборка:

System.Web.dll

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

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

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

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

Protected Overridable Function ExecuteDelete (keys As IDictionary, oldValues As IDictionary) As Integer

Параметры

keys

IDictionary

Объект IDictionary или ключи строк, которые будут удалены операцией ExecuteDelete(IDictionary, IDictionary) .

oldValues

IDictionary

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

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

Int32

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

Исключения

NotSupportedException

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

Примеры

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

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

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

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

Комментарии

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

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

Замечание

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

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

• CanDelete