ObjectDataSourceView.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 chamando o método de objeto de negócio 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 -> intProtected Overrides Function ExecuteInsert (values As IDictionary) As IntegerParâmetros
- values
- IDictionary
Um IDictionary dos parâmetros usados com a InsertMethod propriedade para realizar a operação de inserção. Se não houver parâmetros associados ao método, passe null.
Devoluções
O número de linhas inseridas; caso contrário, -1, se o número não for conhecido. Para obter mais informações, veja Insert.
Exceções
A CanInsert propriedade devolve false.
values é null ou vazia.
Observações
A ObjectDataSourceView classe implementa o método herdado ExecuteInsert para inserir dados num armazenamento subjacente usando um objeto de negócio. 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 inserção ser realizada, o OnInserting método é chamado para elevar o Inserting evento. Pode gerir este evento para examinar os valores dos parâmetros e realizar qualquer pré-processamento antes de o Insert método ser chamado.
Para realizar uma operação de inserção, o ObjectDataSourceView controlo usa reflexão para chamar o método identificado pela InsertMethod propriedade e quaisquer parâmetros associados que estejam na values coleção, e depois executa-o. Após a conclusão da operação, o OnInserted método é chamado para elevar o Inserted evento. Pode gerir este evento para examinar quaisquer valores de retorno, códigos de erro e realizar qualquer pós-processamento.
Para mais informações sobre como devolver o número de linhas inseridas, veja Insert.