ObjectDataSourceView.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 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 -> intProtected Overrides Function ExecuteInsert (values As IDictionary) As IntegerParâ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.
