DataSourceView.ExecuteInsert(IDictionary) Método

Definición

Realiza una operación de inserción en la lista de datos que el objeto DataSourceView representa.

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

Parámetros

values
IDictionary

Interfaz IDictionary de pares de nombre/valor utilizada durante una operación de inserción.

Devoluciones

Número de elementos que se insertaron en el espacio de almacenamiento de datos subyacente.

Excepciones

El objeto ExecuteInsert(IDictionary) no admite la operación de DataSourceView.

Ejemplos

En el ejemplo de código siguiente se muestra cómo una clase que extiende la DataSourceView clase puede invalidar la CanInsert propiedad y el ExecuteInsert método . Este ejemplo de código es parte de un ejemplo mayor proporcionado para la clase 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

Comentarios

Los controles enlazados a datos pueden determinar si una ExecuteInsert operación es compatible con un control de origen de datos recuperando el DataSourceView objeto mediante el GetView método y comprobando la CanInsert propiedad .

El values parámetro es un conjunto de pares nombre-valor que representa columnas de datos o campos y los valores correspondientes que se van a insertar.

Nota:

La implementación predeterminada de la DataSourceView clase es iniciar una NotSupportedException excepción. Si extiende la DataSourceView clase , invalide el ExecuteInsert método si la clase admite la inserción en el almacenamiento de datos subyacente.

Se aplica a

Consulte también