GridAttribute (informazioni di riferimento sulle API client)

GridAttribute è supportato sia per le griglie di sola lettura che per le griglie modificabili.

GridAttribute rappresenta i dati nella cella di una griglia modificabile e contiene un riferimento a tutte le celle associate alla colonna. Per informazioni sui metodi disponibili per accedere ai dati in una raccolta, vedere Raccolte (informazioni di riferimento sulle API client ).

GridAttribute supporta anche la raccolta di controlli per le colonne di una riga della griglia selezionata, che fornisce metodi per l'uso con una raccolta di celle associate alla colonna. Ogni cella (GridCell) di una riga di griglia selezionata è analoga a un controllo di una maschera associata a una colonna in una griglia modificabile. Per informazioni sui metodi disponibili per accedere ai dati in una raccolta, vedere Raccolte (informazioni di riferimento sulle API client ).

Suggerimento

Per motivi di prestazioni, una riga (record) in una griglia modificabile non è modificabile fino a quando non viene selezionato il record. Gli utenti devono selezionare un singolo record in una griglia per modificarlo. Dopo aver selezionato un record in una griglia modificabile, Dynamics 365 valuta internamente una serie di elementi, tra cui l'accesso utente al record, se il record è attivo e le convalide delle colonne per garantire che la sicurezza e la validità dei dati vengano rispettate quando si modificano i dati. Prendere in considerazione l'uso dell'evento OnRecordSelect con il metodo getFormContext per accedere ai record nella griglia che si trovano nello stato modificabile.

Methods

GridAttribute supporta i metodi seguenti per le colonne di una riga della griglia selezionata.

Nome	Description
getName	Restituisce il nome logico della colonna di una riga della griglia selezionata.
getRequiredLevel	Restituisce un valore stringa che indica se è necessario o consigliato un valore per la colonna.
setRequiredLevel	Imposta un valore che indica se i dati sono necessari o consigliati per la colonna di una riga della griglia selezionata prima che il record possa essere salvato.
getValue	Recupera il valore dei dati per una colonna.
setValue	Imposta il valore dei dati per una colonna.

Annotazioni

Per selezionare una riga in una griglia modificabile, usare grid.getSelectedRows

Articoli correlati

GridCell
Griglie e sottogrid nelle app basate su modello
Insieme Controls