DataSourceView.ExecuteInsert(IDictionary) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 -> intProtected Overridable Function ExecuteInsert (values As IDictionary) As IntegerPará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.
