Gitterbearbeitung

Auf / SubGrid gesetzt und ein Schalter AllowEdit="true" MainGrid mit der Beschriftung Editable erscheint im Zahnradmenü-Overflow. Das Einschalten schaltet jede deklarierte Spalte, deren Zellrenderer nicht überschrieben wird, in einen Inline-Editor um – der automatisch aus den Dataverse-Metadaten der Spalte gesendet wird –, während ein GridTemplateColumn's EditChildContent den Lesemodus ChildContentübernimmt. Bearbeitungen sammeln sich als ausstehende Zeilenänderungen im transaktionalen Puffer des Grids auf und landen nur in Dataverse, wenn der Benutzer speichert.

Bearbeiten aktivieren

Auf dem Raster gesetzt AllowEdit="true" . Das Bearbeiten erfolgt pro Raster – der Schalter erscheint nur, wenn der Parameter gesetzt ist, und der Schalter selbst ist nur sichtbar, wenn mindestens eine Spalte bearbeitbar ist. Während der Schalter ausgeschaltet ist, verhält sich das Raster wie eine Nur-Lese-Ansicht; Während sie aktiv ist, werden die Zellen ihre Inline-Editoren gerendert und nicht gespeicherte Änderungen werden pro Zeile verfolgt.

Warum ein Schalter?

Inline-Edit ändert das Rendering der Zellen für jede sichtbare Zeile, was eine andere Leseaffordanz als ein statisches Raster darstellt. Der Schalter erlaubt es den Nutzern, die Bearbeitungsmöglichkeit zu wählen, wenn sie sie brauchen (einen Wert eingeben, Tabben über Zellen hinweg usw.) und behält die sauberere Lesemöglichkeit für den Rest der Zeit. Das Raster merkt sich den Umschaltstatus der Sitzung.

Automatische Editor-Dispatch

Bare-Deklarationen <GridColumn ColumnName="..." /> ohne ChildContent automatisches Dispatchen des richtigen Inline-Editors, während das Raster im Bearbeitungsmodus ist. Das Framework liest die Metadaten der Spalte und wählt die Editor-Unterklasse aus:

• String, Memo, EmailAddress, Phone, — Url TextEdit (mit formatgerechter Validierung).
• Integer, Decimal, Double, BigInt — NumberEdit (ortsbewusstes Parsen, Min/Max aus Metadaten).
• Boolean — BoolEdit (dargestellt als Schalter, zentrierte Ausrichtung).
• Picklist — ChoiceEdit (option-set-gesteuerte Dropdown-Menü, lokalisierte Labels).
• MultiSelectPicklist — MultiSelectChoiceEdit.
• Lookup, Customer, Owner — LookupEdit (typeahead-gesteuert, respektiert Erlaubnislisten der Zieltabelle).
• DateTime, DateOnly — DateTimeEdit.
• Money— MoneyEdit (Währungssymbolpräfix aus ).transactioncurrencyid
• File, Image — FileEdit / ImageEdit (Drag-Drop-Upload).

Übernahme des Standardeditors

Bereitstellen ChildContent Sie ein GridColumn , um sowohl die Lesemodusanzeige ALS auch den Bearbeitungsmodus-Editor für diese Spalte zu übernehmen. Sobald ChildContent gesetzt ist, hört das Framework auf, den metadatengesteuerten Editor automatisch zu senden – rendert den gewünschten Editor innerhalb der Vorlage und sperrt dessen Sichtbarkeit vom Grid-Flag Editable ab. Standard-Editoren (TextEdit, NumberEdit, ) ColumnEditwurden in die Vorlage automatisch verdrahtet, um über den kaskadierenden Zeilenkontext Dirty Tracking und Validierung durchzuführen.

Validierung

Jede Reihe behält ihre eigene EditContextValidator. Standard-Editoren registrieren ihn am Mount und weisen ihre Fehler in der Reihe auf (rote Unterstreichung + Tooltip auf der Zelle). Die Speichertaste des Rasters ist deaktiviert, während jede Zeile einen ungelösten Validierungsfehler zeigt. Validierungsregeln stammen aus den Spaltenmetadaten:

• RequiredLevel — ist die Spalte erforderlich, und ein leerer Wert blockiert das Speichern.
• Format auf String-Spalten – E-Mail, Telefon, URL-Formate erzwingen die Form oben auf dem Typ.
• MinValue / MaxValue in numerischen Spalten — Werte außerhalb des Bereichs werden vor dem Speichern markiert.
• Benutzerdefinierte Validierung – zusätzliche Regeln pro Form über die EditContextValidator API für feldübergreifende Invarianten registrieren (z. B. "Kontakt muss entweder E-Mail oder Telefon haben").

Validierung bei benutzerdefinierten Widgets

Benutzerdefinierte Eingaben, die innerhalb ChildContent gerendert werden oder EditChildContent nicht erweitert BaseEdit werden (z. B. ein RAW FluentTextField oder ein Drittanbieter-Widget), werden nicht automatisch beim Validator der Zeile registriert. Wenn du sie validieren möchtest, verzichte entweder auf einen Standardeditor statt auf das rohe Widget oder führe die Validierung manuell im Callback des Widgets ValueChanged durch, bevor du aufgerufen editCtx.SetValuewirst.

Speichern & Stornieren

Bearbeitungen sammeln sich als ausstehende Updates in der Zeile an – modifizierte Zellen erhalten einen kleinen "schmutzig"-Indikator, gelöschte Zeilen werden durchgestrichen, und ausstehende Erstellungszeilen werden als neu angezeigt. Die Werkzeugleiste des Rasters zeigt Speichern und Abbrechen-Buttons auf, wenn ausstehende Änderungen vorliegen: Save commit den Batch in einem transaktionalen Durchgang; Cancel verwirft den Puffer und setzt jede Zeile auf ihren Serverzustand zurück. Koppele mit NewRecordGridButton und DeleteRecordGridButton im Fragment Buttons , um Zeilenerstellung und -löschung zur selben Bearbeitungstransaktion hinzuzufügen.

Vorlagen-Spalten-Bearbeitung

Koppele den Lesemodus ChildContent von 'GridTemplateColumns mit an, EditChildContent um eine synthetische/zusammengesetzte Spalte editierbar zu machen. Die Bearbeitungsvorlage erhält einen GridTemplateColumnEditContext — denselben Zeilenkontext wie die Lesevorlage (editCtx.Row.PrimaryRecord, der optionale editCtx.Row.ParentRecord in einem SubGrid, editCtx.DependsOnMetadata) plus einen imperativen editCtx.SetValue(columnName, value) Helfer.

EditChildContent löst nur aus, wenn das Raster bearbeitbar ist (AllowEdit="true" UND der Wechselbare Schalter aktiviert ist) und die Zeile nicht auf 'Pending-Delete' steht. Vorlagenspalten, die sie weglassen EditChildContent , bleiben auch im Bearbeitungsmodus nur lesbar – nützlich für Aktionsspalten, die immer dieselben Buttons darstellen sollten.

Muster 1 — Standard-Editoren für Drop-in

Der häufigste Fall: Die Zelle besteht aus mehreren gebundenen Spalten, und du möchtest dem Benutzer erlauben, jede einzelne zu bearbeiten. Fügen Sie die Matching <TextEdit> / <NumberEdit> / Editoren <ColumnEdit> hinein EditChildContent – das Framework kaskadierend den primären Datensatz und das Matching EditContextValidator der Reihe in diesen Scope, sodass die Editoren sich selbst registrieren, um Dirty Tracking und Validierung zu überprüfen. Keine zusätzliche Verkabelung erforderlich.

Muster 2 — Benutzerdefiniertes Widget mit SetValue

Wenn die Editor-Oberfläche nicht 1:1 einer Dataverse-Spalte zugeordnet ist – also einem einzigen "First Last"-Textfeld, das in zwei Spalten geteilt wird, einem Schieberegler, der an mehrere Prozentfelder gebunden ist, einem benutzerdefinierten Date-Range-Picker, der Start + Ende schreibt – rendere du für jede betroffene Spalte deine eigene Eingabe und den Aufruf editCtx.SetValue(columnName, value) . Das Framework leitet den Schreib an die richtige AliasedTableRecord Stelle und startet ValueChanged , sodass Dirty-Tracking die Änderung erkennt.

Validierung auf dem imperativen Weg

Standard-Editoren wurden automatisch in EditChildContent die Register der Zeilen EditContextValidator eingefügt und nehmen am Validate-before-Save-Gate des Frameworks teil. Der Pfad editCtx.SetValue umgeht diese Pipeline – Werte, die nicht von einem registrierten Editor stammen, werden nicht validiert. Wenn dein benutzerdefiniertes Widget Constraints erzwingen muss, führe sie im ValueChanged Callback aus, bevor du aufrufst SetValue, oder greife auf das Drop-in-Editor-Muster zurück.