DataSourceView.ExecuteInsert(IDictionary) Метод

Определение

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

System.Web.UI

Сборка:

System.Web.dll

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

protected:
 virtual int ExecuteInsert(System::Collections::IDictionary ^ values);

protected virtual int ExecuteInsert(System.Collections.IDictionary values);

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

Protected Overridable Function ExecuteInsert (values As IDictionary) As Integer

Параметры

values

IDictionary

Пара имен и значений, используемая IDictionary во время операции вставки.

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

Int32

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

Исключения

NotSupportedException

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

Примеры

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

// The CsvDataSourceView does not currently
// permit insertion of a new record. You can
// modify or extend this sample to do so.
public override bool CanInsert {
    get {
        return false;
    }
}
protected override int ExecuteInsert(IDictionary values)
{
    throw new NotSupportedException();
}

' The CsvDataSourceView does not currently
' permit insertion of a new record. You can
' modify or extend this sample to do so.
Public Overrides ReadOnly Property CanInsert() As Boolean
   Get
      Return False
   End Get
End Property

Protected Overrides Function ExecuteInsert(values As IDictionary) As Integer
   Throw New NotSupportedException()
End Function 'ExecuteInsert

Комментарии

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

Параметр values представляет собой набор пар name/value, представляющих столбцы данных или поля и соответствующие значения для вставки.

Замечание

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

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

• CanInsert