Comparteix via


GridAttribute (referència de l'API de client)

GridAttribute és compatible tant per a quadrícules de només lectura com editables.

GridAttribute representa les dades de la cel·la d'una quadrícula editable i conté una referència a totes les cel·les associades amb la columna. Vegeu Col·leccions (referència de l'API de client) per obtenir informació sobre els mètodes disponibles per accedir a les dades d'una col·lecció.

GridAttribute també admet la col·lecció de controls per a columnes d'una fila de quadrícula seleccionada, que proporciona mètodes per treballar amb una col·lecció de cel·les associades amb la columna. Cada cel·la (GridCell) d'una fila de quadrícula seleccionada és anàloga a un control d'un formulari que està lligat a una columna d'una quadrícula editable. Vegeu Col·leccions (referència de l'API de client) per obtenir informació sobre els mètodes disponibles per accedir a les dades d'una col·lecció.

Propina

Per motius de rendiment, una fila (registre) d'una quadrícula editable no es pot editar fins que no se selecciona el registre. Els usuaris han de seleccionar un sol registre en una quadrícula per editar-lo. Un cop seleccionat un registre en una quadrícula editable, el Dynamics 365 avalua internament una sèrie de coses, com ara l'accés de l'usuari al registre, si el registre està actiu i les validacions de columna per garantir que la seguretat i la validesa de les dades es respecten quan editeu les dades. Considereu la possibilitat d'utilitzar l'esdeveniment OnRecordSelect amb el mètode getFormContext per accedir als registres de la quadrícula que es troben en estat editable.

Mètodes

GridAttribute admet els mètodes següents per a les columnes d'una fila de quadrícula seleccionada.

Nom Descripció
getName Retorna el nom lògic de la columna d'una fila de quadrícula seleccionada.
getRequiredLevel Retorna un valor de cadena que indica si un valor per a la columna és obligatori o recomanat.
setRequiredLevel Defineix si les dades són necessàries o recomanades per a la columna d'una fila de quadrícula seleccionada abans de poder desar el registre.
getValue Recupera el valor de dades d'una columna.
setValue Defineix el valor de dades d'una columna.

Nota

Per seleccionar una fila en una quadrícula editable, utilitzeu la quadrícula. getSelectedRows

Cèl·lula de quadrícula
Quadrícules i subquadrícules en aplicacions basades en models
Col·lecció de controls