Transação de classe
Fornece um escopo para ler e escrever com segurança em um Realm . Deve ser usado explicitamente via Comece a escrever() .
Implementos
namespace: Realms
Conjunto: Realm.exe
Sintaxe
public class Transaction : IDisposable
Observações
Todo o acesso a um Realm ocorre dentro de uma transação. Transação de leitura são criadas implicitamente.
Propriedades
| Editar esta página Ver fonteEstado
Obtém o estado desta transação.
Declaração
public TransactionState State { get; }
Valor da propriedade
Tipo | Descrição |
---|---|
Estado da transação | O estado da transação. |
Métodos
| Editar esta página Ver fonteCommit()
Use para salvar as alterações no Realm. Se a transação for declarada em um bloco using
, ela deverá ser usada antes do final desse bloco.
Declaração
public void Commit()
CommitAsync(CancelationToken)
Use para salvar as alterações no Realm. Se a transação for declarada em um bloco using
, ela deverá ser usada antes do final desse bloco. Ele é concluído quando as alterações são efetivamente gravadas no disco.
Declaração
public Task CommitAsync(CancellationToken cancellationToken = default)
Parâmetros
Tipo | Nome | Descrição |
---|---|---|
Token de cancelamento | Token de cancelamento | Token de cancelamento opcional para parar de esperar a tarefa retornada. |
Devoluções
Tipo | Descrição |
---|---|
Tarefa | Uma tarefa aguardável que é concluída quando as alterações confirmadas são efetivamente gravadas no disco. |
Observações
O cancelamento da tarefa retornada não impedirá a gravação no disco, mas resolverá imediatamente a tarefa com uma TaskCanceredException. Na verdade, a ação de confirmação não pode ser interrompida e continua sendo executada até a conclusão em segundo plano.
Um caso de uso para cancelar essa ação pode ser o fato de você querer mostrar aos usuários um pop-up indicando que os dados estão sendo salvos. Mas você deseja fechar automaticamente esse pop-up após um determinado período de tempo. Ou você pode permitir que os usuários descartem manualmente esse pop-up.
Dispose()
Retomará automaticamente () a transação no escopo existente, se não for explicitamente Comprometida.
Declaração
public void Dispose()
Rollback()
Use explicitamente para desfazer as alterações em uma Transaction, caso contrário, ela será invocada automaticamente ao sair do bloco.
Declaração
public void Rollback()