SqlDataSourceView.ExecuteInsert(IDictionary) Método

  • Referencia

Definición

Espacio de nombres:
System.Web.UI.WebControls
Ensamblado:
System.Web.dll

Realiza una operación de inserción utilizando la cadena SQL InsertCommand, los parámetros especificados en la colección InsertParameters y los valores de la colección values especificada.

protected:
 override int ExecuteInsert(System::Collections::IDictionary ^ values);
protected override int ExecuteInsert (System.Collections.IDictionary values);
override this.ExecuteInsert : System.Collections.IDictionary -> int
Protected Overrides Function ExecuteInsert (values As IDictionary) As Integer

Parámetros

values
IDictionary

Colección IDictionary de valores utilizados con la propiedad InsertCommand para realizar la operación de inserción de base de datos. Si no hay parámetros asociados a la consulta o la propiedad InsertCommand no es una consulta SQL con parámetros, pase null.

Devoluciones

Int32

Valor que representa el número de filas insertadas en la base de datos subyacente.

Excepciones

InvalidOperationException

El control SqlDataSource no puede establecer una conexión con el origen de datos subyacente.

HttpException

El usuario actual no tiene los permisos necesarios para obtener acceso a la base de datos.

NotSupportedException

La propiedad CanInsert es false.

Comentarios

La SqlDataSourceView clase implementa el método heredado ExecuteInsert para insertar datos en una base de datos. Los desarrolladores de páginas y los autores de controles enlazados a datos no llaman directamente al ExecuteInsert método; en su lugar, use el método expuesto Insert públicamente.

Antes de realizar la operación de inserción, OnInserting se llama al método para generar el Inserting evento. Puede controlar este evento para examinar los valores de los parámetros y realizar cualquier preprocesamiento antes de una inserción.

Para realizar una operación de inserción, el SqlDataSourceView objeto crea un DbCommand objeto mediante el InsertCommand texto y las propiedades asociadas InsertParameters y, a continuación, ejecuta el DbCommand objeto en la base de datos subyacente. Una vez completada la inserción, OnInserted se llama al método para generar el Inserted evento. Puede controlar este evento para examinar los valores devueltos y los códigos de error y para realizar cualquier procesamiento posterior.

Se aplica a

Consulte también