SqlDataSourceView.ExecuteInsert(IDictionary) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Realiza uma operação de inserção usando a InsertCommand string SQL, quaisquer parâmetros especificados na InsertParameters coleção e os valores que estejam 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 de valores usados com a InsertCommand propriedade para realizar a operação de inserção da base de dados. Se não houver parâmetros associados à consulta ou se a InsertCommand propriedade não for uma consulta SQL parametrizada, passe null.
Devoluções
Um valor que representa o número de linhas inseridas na base de dados subjacente.
Exceções
Não conseguem SqlDataSource estabelecer uma ligação com a fonte de dados subjacente.
O utilizador atual não tem as permissões corretas para aceder à base de dados.
A propriedade CanInsert é false.
Observações
A SqlDataSourceView classe implementa o método herdado ExecuteInsert para inserir dados numa base de dados. Os programadores de páginas e os autores de controlo encadernados por dados não chamam diretamente o ExecuteInsert método; em vez disso, utilizam o método exposto Insert publicamente.
Antes de a operação de inserção ser executada, o OnInserting método é chamado para levantar o Inserting evento. Pode gerir este evento para examinar os valores dos parâmetros e realizar qualquer pré-processamento antes da inserção.
Para realizar uma operação de inserção, o SqlDataSourceView objeto constrói um DbCommand objeto usando o InsertCommand texto e quaisquer propriedades associadas InsertParameters , e depois executa o DbCommand objeto contra a base de dados subjacente. Depois de concluído o inserto, o OnInserted método é chamado para elevar o Inserted evento. Pode gerir este evento para examinar quaisquer valores de retorno e códigos de erro e realizar qualquer pós-processamento.