GridColumn / GridColumns

Par défaut, MainGrid et SubGrid affichez la colonne que la vue active du Dataverse revient. Le GridColumn composant vous permet de prendre un contrôle explicite : lorsqu’un ou plusieurs GridColumn enfants sont déclarés, la grille ne rend que ces colonnes, dans l’ordre déclaré, et la projection côté serveur est réécrite pour récupérer exactement l’ensemble déclaré. Utilisez cela pour affiner une grille aux colonnes qui comptent pour une page spécifique, les réorganiser, personnaliser la largeur / l’alignement, fournir des modèles par cellule ou des colonnes de surface qui ne sont pas dans la vue sous-jacente — sans modifier la vue Dataverse elle-même.

Usage de base

Laissez tomber GridColumn des composants à l’intérieur d’un GridColumns wrapper sous la grille. Les noms de colonnes déclarés supplantent la projection du <attribute> FetchXML — le serveur récupère les colonnes déclarées même si elles ne sont pas dans la sélection de colonnes de la vue active. Le TableName paramètre est optionnel en mode déclaré : lorsqu’il est omis, celui de TableName la grille est utilisé (inutile de le répéter à chaque colonne).

Remplacez, non additif

Déclarer un GridColumn enfant passe la grille en mode remplacement : les colonnes déclarées sont l’ensemble des colonnes rendues ET l’ensemble entier des colonnes récupérées. Les colonnes de vue non déclarées ici sont supprimées à la fois du rendu et de la projection du serveur. Si vous voulez la plupart des colonnes de vues avec un ou deux ajustements, supprimez complètement l’enveloppe ou créez une vue personnalisée via CustomViewDefinitions.

Paramètres requis

Chaque GridColumn déclaration comprend :

• ColumnName — Obligatoire. Nom logique de la colonne à projeter. Prend en charge la notation par points pour les colonnes d’entités liées aliasées (primarycontactid.emailaddress1) ; l’alias doit déjà exister en tant que a <link-entity> dans le FetchXML de la vue active.
• TableName — Optionnel. Nom logique du tableau dont les métadonnées décrivent cette colonne. Lorsqu’elle est omise, elle revient à la grille TableName — pratique pour maintenir la marge des consommateurs brève sur les grilles à table unique.

Largeur de colonne

À utiliser Width pour remplacer la largeur stockée de la vue. Accepte toute longueur CSS — pixels ("150px"), pourcentages ("20%"), ou "auto". Sans largeur explicite, la grille revient à la base par défaut dérivée des métadonnées et à la distribution naturelle de la table.

Alignement

À utiliser Align pour remplacer l’alignement horizontal à la fois pour le tête et les cellules du corps. Les colonnes numériques et monétaires sont par défaut ( Align.End alignées à droite) via le plan de rechange basé sur les métadonnées ; les colonnes booléennes sont par défaut . Align.Center Définissez-le explicitement lorsque vous voulez un alignement non par défaut, ou pour aligner une cellule personnalisée de manière cohérente.

Colonnes d’entités liées

Les colonnes à entités liées aliasées utilisent la notation par points correspondant à la façon dont les aliase FetchXML de la vue. L’alias doit déjà être défini comme a <link-entity> dans la vue active. En posant TableName sur la table source , l’alias pointe pour que la résolution des métadonnées tombe sur la bonne entité. Le serveur renvoie ces colonnes avec leur nom d’affichage localisé qualifié par table parente (par exemple « Email (Contact principal) ») — aucune humanisation côté client n’est requise.

Modèles par cellule

Fournir ChildContent pour afficher chaque cellule avec un balisage personnalisé. Le modèle reçoit GridRowContext — sa PrimaryRecord propriété expose la totalité TableRecord de la ligne (valeurs de colonnes tapées, valeurs formatées, permissions, tout). Utile pour la mise en forme conditionnelle (texte rouge au-dessus d’un seuil), les icônes, badges, liens, ou tout ce que vous pouvez construire à partir de l’enregistrement de la ligne.

Enregistrement parent dans les sous-grilles

Lorsque la grille est montée en SubGridtant que , GridRowContext.ParentRecord expose l’enregistrement de l’environnement RecordContext(le parent du SubGrid). Cherchez-la dans un ChildContent modèle lorsque la mise en forme conditionnelle doit comparer la colonne d’une ligne à celle du parent — par exemple, surlignez les contacts qui industrycode ne correspondent pas à celui du compte parent, ou étiquetez les lignes appartenant au propriétaire du parent. null Sur un document autonome MainGrid où il n’y a pas d’enregistrement parent.

Parité de réaction

Le côté Réacte fait surface à la même surface que cellRendererla parentRecord propulsion de '(CellRendererProps.parentRecord).

GridTemplateColumn

Utilisez GridTemplateColumn lorsqu’une colonne ne correspond pas à une seule colonne Dataverse — combinez plusieurs valeurs brutes dans une seule cellule, affichez un badge de statut sur plusieurs champs, ou émettez une cellule d’actions purement décorative sans aucune dépendance aux données. Contrairement à , une colonne modèle n’a pas ColumnName: déclare les colonnes que le moteur de rendu lit DependsOn et le framework les fusionne dans la projection FetchXML, de sorte que les données arrivent GridColumnctx.Row.PrimaryRecord lorsque ton modèle s’exécute. Il ChildContent reçoit un GridTemplateColumnContext (utilisez l’attribut Context="ctx" pour le nommer) qui porte la ligne, le parent SubGrid optionnel, et une recherche préconstruite DependsOnMetadata indexée par les noms de colonnes que vous avez déclarés.

Colonne modèle vs. Contenu enfant de la colonne de grille

GridColumn ChildContent On personnalise toujours une colonne liée — trier, éditer dispatch et l’en-tête de colonne tout clé à partir de son unique ColumnName. Atteignez GridTemplateColumn uniquement lorsqu’il n’y a pas de colonne sous-jacente unique à laquelle vous lier (cellules composites, cellules d’action décoratives, badges de statut combinant plusieurs champs). Mélanger les deux est acceptable — ils s’entrelacent dans l’ordre déclaré à travers l’ensemble de colonnes de la grille.

Colonnes décoratives (sans dépendance aux données)

Passez DependsOn complètement lorsque la cellule affiche du contenu purement décoratif comme des boutons ou des icônes en ligne. La structure monte toujours la colonne à la bonne position dans la table rendue ; Rien n’est ajouté à la projection serveur pour cette colonne.

Modèles d’édition en ligne

Associez le mode ChildContent lecture de a GridTemplateColumnà un EditChildContent pour rendre la colonne modifiable lorsque le bouton Modification de la grille est activé. Le modèle d’édition reçoit un GridTemplateColumnEditContext — même contexte de ligne que le modèle de lecture (editCtx.Row.PrimaryRecord, l’optionnel editCtx.Row.ParentRecord dans une sous-grille, la editCtx.DependsOnMetadata recherche) plus un assistant impératifeditCtx.SetValue(columnName, value).

EditChildContent se déclenche lorsque la grille est modifiable (AllowEdit="true" sur la grille plus l’utilisateur a basculé l’interrupteur Modifiable dans le menu d’engrenages de la barre d’outils), la ligne n’est pas en attente-supprimer, et la colonne elle-même déclare un modèle d’édition. Les colonnes modèles décoratives qui omettent EditChildContent restent en lecture seule même en mode édition — utiles pour les colonnes d’actions qui devraient toujours afficher les mêmes boutons.

Motif 1 — Éditeurs standards à intégrer directement

Le cas le plus courant : la cellule est composée de plusieurs colonnes liées, et vous voulez laisser l’utilisateur modifier chacune d’elles. Supprimez les <TextEdit> éditeurs correspondants / <ColumnEdit> <NumberEdit> / à l’intérieur EditChildContent — le framework cascade l’enregistrement principal et du raccordement EditContextValidator de la ligne dans ce champ, de sorte que les éditeurs s’auto-enregistrent pour le dirty-tracking et la validation exactement comme ils le font sous un binôme .ChildContent<GridColumn> Aucun câblage supplémentaire n’est nécessaire.

Motif 2 — Widget personnalisé avec SetValue

Lorsque la surface de l’éditeur ne correspond pas en 1:1 à une colonne Dataverse — une seule boîte de texte « Premier dernier » qui se divise en deux colonnes, un curseur lié à plusieurs champs de pourcentage, un sélecteur personnalisé par plage de dates écrivant début + fin — affichez votre propre entrée et appelez editCtx.SetValue(columnName, value) chaque colonne affectée. Le framework aroute l’écriture vers la bonne AliasedTableRecord adresse (en gérant les noms de colonnes des entités de lien en notation point) et lance l’événement de ValueChanged l’enregistrement pour que le dirty-tracking et la file d’attente de mise à jour de la ligne récupèrent la modification.

Validation sur le chemin impératif

Les éditeurs standards s’enregistraient EditChildContent automatiquement avec les EditContextValidator lignes et participaient à la porte de validation avant la sauvegarde du framework. Le editCtx.SetValue chemin contourne ce pipeline — le framework ne peut pas valider des valeurs qui ne proviennent pas d’un éditeur enregistré. Si votre widget personnalisé doit imposer des contraintes, exécutez-les dans le ValueChanged rappel avant d’appeler SetValue, ou revenez au modèle d’éditeur à insertion directe quand c’est possible.

Dans une sous-grille

Tout ce qui s’applique à MainGrid fonctionne de la même manière sur SubGrid. Associez les colonnes déclarées aux boutons de la barre d’outils dans le Buttons fragment de rendu pour une expérience d’édition en ligne ciblée à la collection associée à l’enregistrement parent — et combinez avec @@context.ParentRecord des modèles en cellule pour un formatage conditionnel qui touche à la version parent du SubGrid.

Référence de paramètre

Paramètres GridTemplateColumn