SQLiteDatabase.SetForeignKeyConstraintsEnabled(Boolean) Método

Referência

Definição

Namespace:: Android.Database.Sqlite

Assembly:: Mono.Android.dll

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.

Define se as restrições de chave estrangeira estão habilitadas para o banco de dados.

[Android.Runtime.Register("setForeignKeyConstraintsEnabled", "(Z)V", "GetSetForeignKeyConstraintsEnabled_ZHandler")]
public virtual void SetForeignKeyConstraintsEnabled (bool enable);

[<Android.Runtime.Register("setForeignKeyConstraintsEnabled", "(Z)V", "GetSetForeignKeyConstraintsEnabled_ZHandler")>]
abstract member SetForeignKeyConstraintsEnabled : bool -> unit
override this.SetForeignKeyConstraintsEnabled : bool -> unit

Parâmetros

enable: Boolean

True para habilitar restrições de chave estrangeira, false para desabilitá-las.

Atributos: RegisterAttribute

Exceções

IllegalStateException

se as transações are estiverem em andamento quando esse método for chamado.

Comentários

Define se as restrições de chave estrangeira estão habilitadas para o banco de dados.

Por padrão, as restrições de chave estrangeira não são impostas pelo banco de dados. Esse método permite que um aplicativo habilite restrições de chave estrangeira. Ele deve ser chamado sempre que o banco de dados for aberto para garantir que as restrições de chave estrangeira sejam habilitadas para a sessão.

Um bom momento para chamar esse método é logo após a SQLiteOpenHelper#onConfigure chamada #openOrCreateDatabase ou no retorno de chamada.

Quando as restrições de chave estrangeira são desabilitadas, o banco de dados não verifica se as alterações no banco de dados violarão as restrições de chave estrangeira. Da mesma forma, quando as restrições de chave estrangeira são desabilitadas, o banco de dados não executará disparadores de exclusão ou atualização em cascata. Como resultado, é possível que o estado do banco de dados se torne inconsistente. Para executar uma verificação de integridade do banco de dados, chame #isDatabaseIntegrityOk.

Esse método não deve ser chamado enquanto uma transação estiver em andamento.

Consulte também Restrições de chave estrangeira SQLite para obter mais detalhes sobre o suporte a restrições de chave estrangeira.

Documentação Java para android.database.sqlite.SQLiteDatabase.setForeignKeyConstraintsEnabled(boolean).

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Android Open Source Project e usado de acordo com os termos descritos na Creative Commons 2.5 Attribution License.

Aplica-se a

Compartilhar via