GridAttribute (référence de l’API client)

GridAttribute est pris en charge pour les grilles en lecture seule et modifiables.

GridAttribute représente les données dans la cellule d’une grille modifiable et contient une référence à toutes les cellules associées à la colonne. Voir Collections (référence de l’API client) pour plus d’informations sur les méthodes disponibles pour accéder aux données d’une collection.

GridAttribute prend également en charge la collection contrôles pour les colonnes d’une ligne de grille sélectionnée, qui fournit des méthodes pour utiliser une collection de cellules associées à la colonne. Chaque cellule (GridCell) d’une ligne de grille sélectionnée est analogue à un contrôle sur un formulaire qui est lié à une colonne dans une grille modifiable. Voir Collections (référence de l’API client) pour plus d’informations sur les méthodes disponibles pour accéder aux données d’une collection.

Conseil

Pour des raisons de performances, une ligne (enregistrement) d’une grille modifiable n’est pas modifiable tant que l’enregistrement n’est pas sélectionné. Les utilisateurs doivent sélectionner un enregistrement unique dans une grille pour la modifier. Une fois qu’un enregistrement est sélectionné dans une grille modifiable, Dynamics 365 évalue en interne un certain nombre de choses, y compris l’accès des utilisateurs à l’enregistrement, si l’enregistrement est actif et les validations de colonne pour garantir que la sécurité et la validité des données sont respectées lorsque vous modifiez des données. Envisagez d’utiliser l’événement OnRecordSelect avec la méthode getFormContext pour accéder à des enregistrements dans la grille dont l’état est modifiable.

Méthodes

GridAttribute prend en charge les méthodes suivantes pour les colonnes d’une ligne de grille sélectionnée.

Nom	Description
getName	Renvoie le nom logique de la colonne d’une ligne de grille sélectionnée.
getRequiredLevel	Renvoie une valeur de chaîne indiquant si une valeur pour la colonne est requise ou recommandée.
setRequiredLevel	Définit si les données sont requises ou recommandées pour la colonne d’une ligne de grille sélectionnée avant que l’enregistrement puisse être enregistré.
getValue	Récupère la valeur des données pour une colonne.
setValue	Définit la valeur des données pour une colonne.

Notes

Pour sélectionner une ligne dans une grille modifiable, utilisez Grid.getSelectedRows

Articles associés

GridCell
Grilles et sous-grilles des applications basées sur un modèle
Collection de contrôles

Notes

Pouvez-vous nous indiquer vos préférences de langue pour la documentation ? Répondez à un court questionnaire. (veuillez noter que ce questionnaire est en anglais)

Le questionnaire vous prendra environ sept minutes. Aucune donnée personnelle n’est collectée (déclaration de confidentialité).