Compartilhar via


ObjectDataSourceView.ExecuteInsert(IDictionary) Método

Definição

Executa uma operação de inserção chamando o método de objeto empresarial identificado pela InsertMethod propriedade usando a 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 -> int
Protected Overrides Function ExecuteInsert (values As IDictionary) As Integer

Parâmetros

values
IDictionary

Um IDictionary dos parâmetros usados com a InsertMethod propriedade para executar a operação de inserção. Se não houver parâmetros associados ao método, passe null.

Retornos

O número de linhas inseridas; caso contrário, -1, se o número não for conhecido. Para obter mais informações, consulte Insert.

Exceções

A CanInsert propriedade retorna false.

values está null ou está vazio.

Comentários

A ObjectDataSourceView classe implementa o método herdado ExecuteInsert para inserir dados em um armazenamento de dados subjacente usando um objeto de negócios. 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 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 que o Insert método seja chamado.

Para executar uma operação de inserção, o ObjectDataSourceView controle usa reflexão para chamar o método identificado pela InsertMethod propriedade e quaisquer parâmetros associados que estejam na coleção e, em values seguida, executá-lo. Após a conclusão da operação, o OnInserted método é chamado para acionar o Inserted evento. Você pode lidar com esse evento para examinar quaisquer valores retornados, códigos de erro e executar qualquer pós-processamento.

Para obter mais informações sobre como retornar o número de linhas inseridas, consulte Insert.

Aplica-se a

Confira também