Compartilhar via


SqlDataSourceView.ExecuteInsert(IDictionary) Método

Definição

Executa uma operação de inserção usando a cadeia de caracteres SQL InsertCommand, quaisquer parâmetros que estão especificados na coleção InsertParameters e os valores que estão na coleção 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

Um IDictionary de valores usados com a propriedade InsertCommand para executar a operação de banco de dados de inserção. Se não existem parâmetros associados à consulta ou se a propriedade InsertCommand não é uma consulta SQL parametrizada, passa null.

Retornos

Um valor que representa o número de linhas inseridas no banco de dados subjacente.

Exceções

O SqlDataSource não pode 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 manipular esse evento para examinar quaisquer valores retornados e códigos de erro e para executar qualquer pós-processamento.

Aplica-se a

Confira também