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 метода и проверяя DataSourceView CanInsert свойство.

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

Примечание

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

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

• CanInsert