Modificando conjuntos de dados

Quando um aplicativo abre um conjunto de dados de item, o conjunto de dados entra automaticamente no estado navegação. A navegação permite que você visualize registros em um conjunto de dados, mas você não pode editar registros ou inserir novos registros. Você usa principalmente o estado navegação para rolar de um registro para outro em um conjunto de dados.

Para mais informações sobre como navegar entre os registros, consulte Navegando por conjuntos de dados.

A partir do estado navegação, todos os outros estados do conjunto de dados podem ser definidos. Por exemplo, chamar os métodos insert ou append altera seu estado de navegação para inserir.

Dois métodos podem retornar o conjunto de dados ao estado navegação. Cancel termina a edição atual, inserção, e retorna o conjunto de dados ao estado navegação. Post grava as alterações no conjunto de dados e, se bem-sucedido, também retorna o conjunto de dados ao estado navegação. Se essa operação falhar, o estado atual permanece inalterado.

Para verificar o estado do conjunto de dados de um item, use o atributo item_state ou os métodos is_new, is_edited ou is_changing:

Cliente	Servidor	Descrição
item_state	item_state	Indica o estado operacional atual do conjunto de dados do item.
is_new	is_new	Retorna verdadeiro se o conjunto de dados do item estiver no estado inserir.
is_edited	is_edited	Retorna verdadeiro se o conjunto de dados do item estiver no estado editar.
is_changing	is_changing	Retorna verdadeiro se o conjunto de dados do item estiver nos estados inserir ou editar.

Você pode usar os seguintes métodos do item para inserir, atualizar e excluir dados no conjunto de dados:

Cliente	Servidor	Descrição
edit	edit	Coloca o conjunto de dados do item no estado de edição.
append	append	Adiciona um registro ao final do conjunto de dados e coloca o conjunto de dados no estado inserir.
insert	insert	Insere um registro no início do conjunto de dados e coloca o conjunto de dados no estado inserir.
post	post	Salva o novo registro ou o registro alterado e coloca o conjunto de dados no estado navegação.
cancel	cancel	Cancela a operação atual e coloca o conjunto de dados no estado navegação.
delete	delete	Exclui o registro atual e coloca o conjunto de dados no estado navegação.

Todas as alterações feitas no conjunto de dados são armazenadas na memória, os registros do item são alterados no log de alterações. Assim, após todas as alterações serem feitas, elas podem ser armazenadas na tabela do banco de dados associada chamando o método apply. O método apply gera e executa uma consulta SQL para salvar as alterações no banco de dados.

Cliente	Servidor	Descrição
log_changes	log_changes	Indica se as alterações de dados devem ser registradas.
apply	apply	Envia todos os registros atualizados, inseridos e excluídos do conjunto de dados do item para o servidor para gravação no banco de dados.