GridColumn / GridColumns

Por padrão, MainGrid e SubGrid renderize qualquer conjunto de colunas que a visualização ativa do Dataverse retorne. O GridColumn componente permite que você assuma controle explícito: quando um ou mais GridColumn filhos são declarados, a grade renderiza apenas essas colunas, na ordem declarada, e a projeção do lado do servidor é reescrita para buscar exatamente o conjunto declarado. Use isso para reduzir a grade até as colunas que importam para uma página específica, reordená-las, personalizar a largura/alinhamento, fornecer templates por célula ou colunas de superfície que não estejam na visualização subjacente — sem editar a visualização do Dataverse em si.

Uso Básico

Coloque GridColumn componentes dentro de uma GridColumns capa sob a grade. Nomes de colunas declaradas sobrescrevem a projeção do <attribute> FetchXML — o servidor busca as colunas declaradas mesmo que elas não estejam na seleção de colunas da visualização ativa. O TableName parâmetro é opcional no modo declarado: quando omitido, o próprio TableName da grade é usado (não é necessário repeti-lo em cada coluna).

Substituir, não aditivo

Declarar qualquer GridColumn filho muda a grade para o modo de substituição: colunas declaradas são o conjunto inteiro de colunas renderizado E todo o conjunto de colunas buscadas. Colunas de visualização não declaradas aqui são removidas tanto da renderização quanto da projeção do servidor. Se quiser a maioria das colunas de visualização com um ou dois ajustes, abandone completamente o wrapper ou construa uma visualização personalizada via CustomViewDefinitions.

Parâmetros Exigidos

Cada GridColumn declaração leva:

• ColumnName — Obrigatório. Nome lógico da coluna a projetar. Suporta notação pontual para colunas de entidades vinculadas aliasadas (primarycontactid.emailaddress1); o alias já deve existir como a <link-entity> no FetchXML da visualização ativa.
• TableName — Opcional. Nome lógico da tabela cujos metadados descrevem esta coluna. Quando omitido, recorre à grade TableName — útil para manter a margem do consumidor curta em grades de tabela única.

Largura da coluna

Use Width para sobrescrever a largura armazenada da visualização. Aceita qualquer comprimento CSS — pixels ("150px"), porcentagens ("20%"), ou "auto". Sem uma largura explícita, a grade volta ao padrão derivado dos metadados e à distribuição natural da tabela.

Alinhamento

Use Align para sobrescrever o alinhamento horizontal tanto do cabeçalho quanto das células do corpo. Colunas numéricas e de dinheiro têm por padrão ( Align.End alinhadas à direita) via o recurso de respaldo orientado por metadados; colunas booleanas têm por padrão . Align.Center Defina explicitamente quando quiser um alinhamento não padrão, ou para alinhar uma célula com template personalizado de forma consistente.

Colunas de Entidades Vinculadas

Colunas de entidades ligadas com aliasings usam notação de pontos que corresponde ao que o FetchXML da visualização as aliasiza. O alias já deve estar definido como a <link-entity> na visualização ativa. Definido TableName para a tabela de origem para que o alias aponte para que a resolução dos metadados caia na entidade correta. O servidor retorna essas colunas com seu nome de exibição localizado qualificado pela tabela pai (por exemplo, "Email (Contato Primário)") — sem necessidade de humanização do lado do cliente.

Modelos por célula

Forneça ChildContent para renderizar cada célula com marcação personalizada. O template recebe GridRowContext — sua PrimaryRecord propriedade expõe a linha completa TableRecord (valores de colunas digitadas, valores formatados, permissões, tudo). Útil para formatação condicional (texto vermelho acima de um limite), ícones, distintivos, links ou qualquer outra coisa que você possa construir a partir do registro da linha.

Registro Pai em SubGrids

Quando a grade é montada como um SubGrid, GridRowContext.ParentRecord expõe o registro de 's ao redor RecordContext(o pai da SubGrade). Procure dentro de um ChildContent modelo quando a formatação condicional precisar comparar a coluna de uma linha com a do pai — por exemplo, destacar contatos que industrycode não correspondam à conta do pai, ou rotular linhas pertencentes ao dono do pai. null em um registro independente MainGrid onde não há registro pai.

Paridade de reação

O lado React tem a mesma superfície que cellRenderero parentRecord prop de '.CellRendererProps.parentRecord

GridTemplateColumn

Use GridTemplateColumn quando uma coluna não mapeia para uma única coluna do Dataverse — combine vários valores brutos em uma célula, renderize um distintivo de status com chave em vários campos ou emita uma célula de ações puramente decorativas sem dependência de dados. Diferente de GridColumn, uma coluna template não ColumnNametem : declare as colunas pelas quais o renderer lê DependsOn e o framework as funde na projeção FetchXML, para que os dados cheguem quando ctx.Row.PrimaryRecord seu template roda. Ele ChildContent recebe um GridTemplateColumnContext (use o Context="ctx" atributo para nomear) que carrega a linha, o pai SubGrid opcional e uma consulta pré-construída DependsOnMetadata com base nos nomes das colunas que você declarou.

Coluna modelo vs. GridColumn ChildContent

GridColumn ChildContent Ainda personaliza uma coluna limitada — ordenação, despacho de edição e o cabeçalho da coluna todos são dados de seu único ColumnName. Alcance apenas GridTemplateColumn quando não houver uma única coluna subjacente para vincular (células compostas, células decorativas de ação, crachás de status combinando múltiplos campos). Misturar os dois é aceitável — eles se entrelaçam em ordem declarada ao longo do conjunto de colunas da grade.

Colunas decorativas (sem dependência de dados)

Pule DependsOn completamente quando a célula renderiza conteúdo puramente decorativo, como botões ou ícones inline. A estrutura ainda monta a coluna na posição correta da tabela renderizada; Nada é adicionado à projeção do servidor para essa coluna.

Modelos de Edição Inline

Combine o modo ChildContent de leitura de a GridTemplateColumncom um EditChildContent para tornar a coluna editável quando a opção de Editável da grade estiver ativada. O modelo de edição recebe — GridTemplateColumnEditContext o mesmo contexto de linha do modelo de leitura (editCtx.Row.PrimaryRecord, o opcional editCtx.Row.ParentRecord em um SubGrade, a editCtx.DependsOnMetadata consulta) mais um auxiliar imperativoeditCtx.SetValue(columnName, value).

EditChildContent dispara quando a grade é editável (AllowEdit="true" na grade mais o usuário já virou o botão Editável no menu de engrenagens da barra de ferramentas), a linha não está pendente-deletação, e a própria coluna declara um modelo de edição. Colunas de modelo decorativas que não EditChildContent permitem permanecer em modo 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 cascata o registro primário e o matching EditContextValidator da linha para esse escopo, para que os editores se registrem automaticamente para rastreamento sujo e validação exatamente como fazem sob um bound <GridColumn>.ChildContent 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. A framework roteia a escrita para o endereço correto AliasedTableRecord (lidando com os nomes das colunas link-entity da notação ponto) e dispara o evento do ValueChanged registro para que o dirty-tracking e a fila de atualização pendente da linha detectem 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 — o framework não pode validar valores que não vieram de um editor registrado. 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 quando possível.

Em uma SubGrade

Tudo que se aplica a MainGrid funciona de forma idêntica em SubGrid. Parear colunas declaradas com botões de barra de ferramentas no Buttons fragmento de renderização para uma experiência de edição inline focada, direcionada à coleção relacionada ao registro pai — e combine com @@context.ParentRecord templates de célula para formatação condicional que se baseia no pai do SubGrid.

Referência de parâmetros

Parâmetros GridTemplateColumn