SqlDataSourceView.ExecuteInsert(IDictionary) Método

Definición

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

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

de IDictionary valores usados con la InsertCommand propiedad para realizar la operación de inserción de la base de datos. Si no hay ningún parámetro asociado a la consulta o si la InsertCommand propiedad no es una consulta SQL parametrizada, pase null.

Devoluciones

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

Excepciones

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

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

La CanInsert propiedad 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 al ExecuteInsert método directamente; en su lugar, usan 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