Edição em grade

Configurado AllowEdit="true" em MainGrid / SubGrid e uma opção de alternância rotulada como Editável aparece no menu de engrenagens. Ligar a coluna muda toda coluna declarada cujo renderizador de célula não é sobreposto para um editor inline — despachado automaticamente a partir dos metadados Dataverse da coluna — enquanto um GridTemplateColumn's EditChildContent assume seu modo ChildContentde leitura. As edições se acumulam como mudanças pendentes de linha no buffer transacional da grade e só aparecem no Dataverse quando o usuário salva.

Habilitando a edição

Ajustado AllowEdit="true" na grade. A edição é opt-in por grade — a opção só aparece quando o parâmetro está definido, e a opção só é visível quando pelo menos uma coluna é editável. Enquanto a alavanca está desligada, a grade se comporta como uma visualização somente de leitura; Enquanto está ligado, as células renderizam seus editores inline e as alterações não salvas são rastreadas por linha.

Por que uma opção de alternar?

A edição em linha altera a renderização das células para cada linha visível, o que é uma possibilidade de leitura diferente de uma grade estática. O toggle permite que os usuários optem pela opção de edição quando precisarem (digitando um valor, separando células, etc.) e mantendo a opção de leitura limpa pelo restante do tempo. A grade lembra o estado de alternância da sessão.

Despacho automático do editor

<GridColumn ColumnName="..." /> Declarações sem ChildContent despacho automático do editor inline direito enquanto a grade está em modo de edição. O framework lê os metadados da coluna e escolhe a subclasse editor:

• String, Memo, EmailAddress, Phone, Url — TextEdit (com validação apropriada ao formato).
• Integer, Decimal, Double, BigInt — NumberEdit (análise sintática consciente da localização, mínimo/máximo a partir dos metadados).
• Boolean — BoolEdit (renderizado como um interruptor, alinhamento centralizado).
• Picklist — ChoiceEdit (menu suspenso orientado por conjunto de opções, rótulos localizados).
• MultiSelectPicklist — MultiSelectChoiceEdit.
• Lookup, Customer, Owner — LookupEdit (orientado por typeahead, respeita listas de permitir a tabela de alvo).
• DateTime, DateOnly — DateTimeEdit.
• Money — MoneyEdit (prefixo de símbolo de moeda de transactioncurrencyid).
• File, Image — FileEdit / ImageEdit (upload arrastando-solta).

Sobrescrevendo o editor padrão

Suprima ChildContent em um GridColumn para assumir tanto a exibição do modo de leitura quanto do editor do modo de edição para aquela coluna. Uma vez ChildContent definido, o framework para de despachar automaticamente o editor orientado por metadados — renderize qualquer editor que você quiser dentro do template e bloqueie sua visibilidade pela bandeira da Editable grade. Editores padrão (TextEdit, NumberEdit, ColumnEdit) foram inseridos no template que se conectam automaticamente ao dirty-tracking e validação via o contexto da linha em cascata.

Validação

Cada linha mantém seu EditContextValidatorpróprio . Editores padrão registram com ele no suporte e exibem seus erros em linha (sublinhado vermelho + dica de ferramenta na célula). O botão de salvar da grade está desativado enquanto qualquer linha apresenta um erro de validação não resolvido. As regras de validação vêm dos metadados da coluna:

• RequiredLevel — a coluna é necessária, e um valor vazio bloqueia o salvamento.
• Format nas colunas string — e-mail, telefone e formatos de URL impõem a forma sobre o tipo.
• MinValue / MaxValue em colunas numéricas — valores fora de faixa são sinalizados antes do salvamento.
• Validação personalizada — registrar regras adicionais por forma via API EditContextValidator para invariantes entre campos (por exemplo, "contato deve ter e-mail ou telefone").

Validação em widgets personalizados

Entradas personalizadas renderizadas dentro ChildContent / EditChildContent que não se estendem BaseEdit (por exemplo, um widget raw FluentTextField ou de terceiros) não se registram automaticamente com o validador da linha. Se precisar que eles sejam validados, ou descarte um editor padrão em vez do widget bruto, ou execute a validação manualmente dentro do callback do ValueChanged widget antes de chamar editCtx.SetValue.

Salvar e Cancelar

Edições se acumulam como atualizações pendentes na linha — células modificadas recebem um pequeno indicador "sujo", linhas excluídas são riscadas, e linhas de criação pendente aparecem como novas. A barra de ferramentas da grade mostra os botões Salvar e Cancelar sempre que há alterações pendentes: Salvar faz commit do lote em uma única passagem transacional; Cancelar descarta o buffer e reverte cada linha para o estado do servidor. Pareie com NewRecordGridButton e DeleteRecordGridButton no Buttons fragmento para adicionar criação e exclusão de linhas à mesma transação de edição.

Edição de Colunas de Modelo

Combine o modo ChildContent de leitura de a GridTemplateColumncom um EditChildContent para tornar uma coluna sintética/composta editável. O modelo de edição recebe — GridTemplateColumnEditContext o mesmo contexto de linha do template de leitura (editCtx.Row.PrimaryRecord, o opcional editCtx.Row.ParentRecord em um SubGrid, editCtx.DependsOnMetadata) mais um auxiliar imperativoeditCtx.SetValue(columnName, value).

EditChildContent dispara apenas quando a grade é editável (AllowEdit="true" E a opção de Editável está ativada) e a linha não está pendente-deletação. Colunas de modelo que omitem EditChildContent permanecem somente leitura mesmo no modo de edição — úteis para colunas de ações que sempre devem renderizar os mesmos botões.

Padrão 1 — Editores padrão disponíveis

O caso mais comum: a célula é composta por múltiplas colunas vinculadas, e você quer deixar o usuário editar cada uma. Coloque os editores correspondentes <TextEdit> / <ColumnEdit> <NumberEdit> / dentro EditChildContent — o framework encadeia o registro primário e a correspondência EditContextValidator da linha nesse escopo, para que os editores se registrem para rastreamento e validação sujos. Não é necessário fiação extra.

Padrão 2 — Widget personalizado com SetValue

Quando a superfície do editor não mapeia 1:1 para uma coluna do Dataverse — uma única caixa de texto "Primeiro Último" que se divide em duas colunas, um controle deslizante vinculado a múltiplos campos percentuais, um seletor personalizado por intervalo de datas escrevendo início e fim — renderize sua própria entrada e chame editCtx.SetValue(columnName, value) para cada coluna afetada. O framework roteia a escrita para o correto AliasedTableRecord e dispara ValueChanged para que o dirty-tracking capture a alteração.

Validação no caminho imperativo

Editores padrão se registravam EditChildContent automaticamente com as EditContextValidator linhas e participavam do portão de validação antes do save do framework. O editCtx.SetValue caminho contorna esse pipeline — valores que não vieram de um editor registrado não são validados. Se seu widget personalizado precisar impor restrições, execute-as dentro do ValueChanged callback antes de chamar SetValue, ou volte ao padrão de editor drop-in.