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 representa el DataSourceView objeto.
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
De IDictionary pares nombre-valor usados durante una operación de inserción.
Devoluciones
Número de elementos que se insertaron en el almacenamiento de datos subyacente.
Excepciones
La ExecuteInsert(IDictionary) operación no es compatible con .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 forma parte de un ejemplo más grande proporcionado para la DataSourceView clase .
// 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 objeto mediante el DataSourceViewGetView 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.
