Partilhar via


ObjectDataSourceView.ExecuteInsert(IDictionary) Método

Definição

Executa uma operação de inserção chamando o método de objeto de negócios identificado pela propriedade InsertMethod usando a 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 parâmetros usados com a propriedade InsertMethod para executar a operação de inserção. Se não houver nenhum parâmetro associado 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 propriedade CanInsert retorna false.

values é null ou 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 propriedade e todos os InsertMethod parâmetros associados que estão na coleção e, em values seguida, o executa. Após a conclusão da operação, o OnInserted método é chamado para acionar o Inserted evento. Você pode manipular 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