MainContext

O MainContext componente é usado para encapsular um ou mais RecordContexts, SubGrids, ManyToManyLookupEditors ou coordena e coordena save, refresh, validation e rastreamento de estado sujo entre todos eles.

Componentes Filhos

A MainContext pode conter qualquer combinação dos seguintes componentes filhos:

• RecordContext — Envolve um único registro do Dataverse para edição.
• SubGrid — Exibe e gerencia uma coleção de registros relacionados.
• ManyToManyLookupEditor — Gerencia relacionamentos muitos-para-muitos.

Salvando

Inclua um SaveContextButton dentro de um MenuBar para permitir que os usuários persistam as alterações. Quando o botão de salvar é clicado, todos os registros sujos de todos os componentes filhos são salvos em uma única requisição transacional para o Dataverse. Se algum registro falhar ao salvar, toda a transação é revertida e nenhuma alteração é mantida.

Refrescante

Inclua um RefreshContextButton para permitir que os usuários descartem alterações não salvas e recarreguem os registros do Dataverse. Se houver alterações não salvas, o usuário recebe uma mensagem de confirmação antes da atualização ser realizada.

Validação

Por padrão, valida MainContext todos os componentes filhos antes de salvar. Defina ForceSuccessfulValidationBeforeSave para false desativar esse comportamento.

Rastreamento de Estado Sujo

Ele MainContext rastreia automaticamente se algum componente filho tem alterações não salvas via a IsDirty propriedade. Se um usuário tentar sair da página enquanto há alterações não salvas, uma caixa de confirmação é exibida. Defina DisableUnsavedChangesWarning para true suprimir esse diálogo para alterações de navegação. O aviso sempre aparece ao atualizar, independentemente dessa configuração.

Interceptação de Defesa

Use o OnBeforeSave callback para rodar lógica personalizada antes da operação de salvamento. Definido CancelEventArgs.Cancel para true impedir que o teste continue com o save.