Freigeben über

GridAttribute (Client-API-Referenz)

  • Artikel

GridAttribute wird sowohl für schreibgeschützte als auch für bearbeitbare Raster unterstützt.

GridAttribute repräsentiert die Daten in der Zelle eines bearbeitbaren Rasters und enthält einen Verweis auf alle der Spalte zugeordneten Zellen. Soehe Sammlungen (Client-API-Referenz) für Informationen zu Methoden zum Zugreifen auf Daten in einer Sammlung.

GridAttribute unterstützt auch das Steuerelement Sammlung für Spalten einer ausgewählten Rasterzeile, die Methoden zum Arbeiten mit einer Sammlung von Zellen bereitstellt, die der Spalte zugeordnet sind. Jede Zelle (GridCell) einer ausgewählten Rasterzeile entspricht einem Steuerelement in einem Formular, das an eine Spalte in einem bearbeitbaren Raster gebunden ist. Soehe Sammlungen (Client-API-Referenz) für Informationen zu Methoden zum Zugreifen auf Daten in einer Sammlung.

Tipp

Aus Leistungsgründen ist eine Zeile (Datensatz) in einem bearbeitbaren Raster nicht bearbeitet, bis der Datensatz ausgewählt ist. Benutzer müssen einen einzelnen Datensatz in einem Raster auswählen, um ihn zu bearbeiten. Sobald ein Datensatz in einem bearbeitbaren Raster ausgewählt wurde, wertet Dynamics 365 intern eine Reihe von Dingen aus, darunter den Benutzerzugriff auf den Datensatz, ob der Datensatz aktiv ist, und Spaltenüberprüfungen, um sicherzustellen, dass Datensicherheit und -gültigkeit beim Bearbeiten von Daten berücksichtigt werden. Sie können das OnRecordSelect Ereignis mit der getFormContext-Methode verwenden, um auf Datensätze im Raster zuzugreifen, die einen bearbeitbaren Status aufweisen.

Methoden

GridAttribute unterstützt die folgenden Methoden für Spalten einer ausgewählten Rasterzeile.

Name Beschreibung
getName Gibt den logischen Namen der Spalte einer ausgewählten Rasterzeile zurück.
getRequiredLevel Gibt einen Zeichenfolgenwert zurück, der angibt, ob ein Wert für die Spalte erforderlich oder empfohlen ist.
setRequiredLevel Legt fest, ob Daten für die Spalte einer ausgewählten Rasterzeile erforderlich oder empfohlen werden, bevor der Datensatz gespeichert werden kann.
getValue Ruft den Datenwert für eine Spalte ab.
setValue Legt den Datenwert für eine Spalte fest.

Anmerkung

Wenn Sie eine Zeile in einem bearbeitbaren Raster auszuwählen, verwenden Sie Grid.getSelectedRows

GridCell
Raster und Unterraster in modellgesteuerten Apps
Steuerelementsammlung