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.

Conhecendo a Célula: CellTemplate

ChildContent recebe a linha, que todas as células nela compartilham, então não pode saber qual coluna está renderizando — ou qual a busca da grade correspondeu nela. Quando a célula precisar saber, fornece CellTemplate em vez disso. Ela recebe um GridColumnCellContext: a Rowcélula ColumnName, Metadata e digitada Value, a DisplayValue célula embutida mostraria, e Highlight(text), que marca exatamente o que a busca correspondeu como as células embutidas — o termo de busca nas colunas de texto, busca e escolha, e o valor total de uma coluna de número ou data cuja comparação vale. Ela tem precedência sobre ChildContent quando ambas são definidas. No React a cellRenderer já recebe o texto da valuecélula , metadata e searchText: passe searchText para <Highlighter> para texto, e para uma coluna numérica ou dinheiro verifique com parseNumericSearch e matchesNumericSearch, e para uma coluna de data com parseDateSearch e matchesDateSearch — que pega o texto formatado da célula em vez de seu valor, já que o dia em que uma data cai depende do fuso horário em que é mostrado e da localidade de useLocale() — marcando o valor com <HighlightFull> quando correspondem.

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.

Uma coluna modelo não faz parte da busca da grade, a menos que você diga por qual ser buscada. SearchBy (searchBy no React) nomeia as colunas: elas são buscadas automaticamente, correspondidas pelas regras usuais da grade para seu tipo (o texto começa com a busca, ou o contém após um início *; uma coluna de número ou data é comparada) e listadas na caixa de busca sob o título da coluna do modelo. As colunas em DependsOn são apenas buscadas, nunca pesquisadas — um código de status atrás de um distintivo não deveria corresponder ao que alguém digita. Para marcar o que a busca correspondeu do jeito que as células embutidas, renderize o texto da célula no ctx.Highlight(text) Blazor, ou passe o do renderizador searchText para <Highlighter> no React; ambos ficam vazios para uma coluna sem SearchBy.

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