SqlDataSourceView.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 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 -> intProtected Overrides Function ExecuteInsert (values As IDictionary) As IntegerPará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
Valor que representa el número de filas insertadas en la base de datos subyacente.
Excepciones
El control SqlDataSource no puede establecer una conexión con el origen de datos subyacente.
El usuario actual no tiene los permisos necesarios para obtener acceso a la base de datos.
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.
