SqlDataSourceView.ExecuteInsert(IDictionary) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Executa uma operação de inserção usando a InsertCommand cadeia de caracteres SQL, todos os parâmetros especificados na InsertParameters coleção e os valores que estão na coleção especificada values .
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
Um IDictionary dos valores usados com a InsertCommand propriedade para executar a operação de inserção de banco de dados. Se não houver parâmetros associados à consulta ou se a InsertCommand propriedade não for uma consulta SQL parametrizada, passe null.
Retornos
Um valor que representa o número de linhas inseridas no banco de dados subjacente.
Exceções
Não SqlDataSource é possível estabelecer uma conexão com a fonte de dados subjacente.
O usuário atual não tem as permissões corretas para obter acesso ao banco de dados.
A propriedade CanInsert é false.
Comentários
A SqlDataSourceView classe implementa o método herdado ExecuteInsert para inserir dados em um banco de dados. Desenvolvedores de páginas e autores de controle associados a dados não chamam o ExecuteInsert método diretamente; em vez disso, use o método exposto Insert publicamente.
Antes que a operação de inserção seja executada, o OnInserting método é chamado para acionar o Inserting evento. Você pode manipular esse evento para examinar os valores dos parâmetros e executar qualquer pré-processamento antes de uma inserção.
Para executar uma operação de inserção, o SqlDataSourceView objeto cria um DbCommand objeto usando o InsertCommand texto e quaisquer propriedades associadas InsertParameters e, em seguida, executa o DbCommand objeto no banco de dados subjacente. Após a conclusão da inserção, o OnInserted método é chamado para acionar o Inserted evento. Você pode lidar com esse evento para examinar quaisquer valores retornados e códigos de erro e executar qualquer pós-processamento.