LookupRecordContext

Die Komponente LookupRecordContext lädt und bietet Bearbeitungszugriff auf den Datensatz, der durch ein Nachschlagefeld im Elternfeld RecordContextreferenziert wird. Es erbt von BaseColumnEdit, also bindet es über den Parameter ColumnName an eine Spalte, genau wie jeder andere Editor.

Wie es funktioniert

Wenn Sie ein LookupRecordContext in a RecordContext legen und ein ColumnName spezifizieren, das auf ein Nachschlagefeld abgebildet ist, liest die Komponente automatisch den Nachschlagwert aus dem übergeordneten Datensatz, ruft den referenzierten Datensatz aus Dataverse ab und stellt ihn als verschachteltes RecordContextObjekt frei. Alle Editoren, die innerhalb der LookupRecordContext Bindung zu den Feldern des nachgeschlagenen Datensatzes platziert werden.

ColumnName

Der Parameter ColumnName muss sich auf eine Nachschlagespalte im Elterndatensatz beziehen. Die Komponente verwendet dies, um die Zieltabelle und die Datensatz-ID aufzulösen.

React
Blazor

Kontextvorlage

Zum Beispiel RecordContextkannst du den ContextTemplate Parameter verwenden, anstatt ChildContent direkt auf das nachgeschlagene TableRecord Objekt in deinem Markup zuzugreifen.

React
Blazor

Sparen

Änderungen an Feldern innerhalb eines LookupRecordContext werden als Teil der Elternspeicherung MainContext gespeichert. Der Rückruf OnBeforeSave kann verwendet werden, um benutzerdefinierte Logik auszuführen oder den Speicherstand abzubrechen.

React
Blazor

Programmatischer Zugang

Die Eigenschaft RecordContext bietet Zugriff auf das Innere RecordContext für programmatische Operationen wie das Auffrischen oder Überprüfen des Dirty State.

React
Blazor

Beispiel

Das folgende Beispiel zeigt ein Kontoformular, das die Details des primären Kontakts inline anzeigt, indem er eine LookupRecordContext Bindung zum Suchfeld verwendet primarycontactid .

React-Beispiel
Blazor-Beispiel
Konto
Primärer Kontakt
React TypeScript
Razor
Reagieren Blazor

LookupRecordContext Baureihe

Parameter

Name
Typ
Default
Beschreibung
ChildContentRenderFragment?
Kindinhalt der Komponente
ColumnName*string
Spaltenlogischer Name, um den Editor aus dem Tabelleneintrag zu binden.
ContextTemplateRenderFragment<TableRecord>
Rendere ein Fragment, das den geladenen Datensatz zur Darstellung oder Bearbeitung erhält.
Descriptionstring?
Beschreibung wird im Tooltip angezeigt.
Disabledbool?
Sollte der Editor deaktiviert werden?
DisplayLabelWhenAvailablebool
True
Gibt an, ob eine Etikette angezeigt werden soll, falls verfügbar.
DisplayTooltipWhenAvailablebool
True
Gibt an, ob ein Tooltip angezeigt werden soll, falls verfügbar.
DisplayValidationErrorMessagebool
True
Sollte eine Fehlermeldung zur Validierung angezeigt werden, wenn die Komponente die Validierung nicht besteht?
IsVisiblebool
True
Ist der Editor sichtbar?
Labelstring?
Text soll als Etikett für den Editor angezeigt werden.
ReadOnlybool?
Sollte der Editor nur lesegeschützt sein?
RecordContextRecordContext
Bietet Zugang zum inneren LookupRecordContext.RecordContext Gebäude für programmatische Operationen.
Requiredbool?
Sollte der Wert erforderlich sein.
ValueLookupValue?
Der aktuelle Lookup-Wert (Referenz), der von diesem Kontext verwaltet wird.
Name: ChildContent
Typ: RenderFragment?
Beschreibung: Kindinhalt der Komponente
Name: ColumnName*
Typ: string
Beschreibung: Spaltenlogischer Name, um den Editor aus dem Tabelleneintrag zu binden.
Name: ContextTemplate
Typ: RenderFragment<TableRecord>
Beschreibung: Rendere ein Fragment, das den geladenen Datensatz zur Darstellung oder Bearbeitung erhält.
Name: Description
Typ: string?
Beschreibung: Beschreibung wird im Tooltip angezeigt.
Name: Disabled
Typ: bool?
Beschreibung: Sollte der Editor deaktiviert werden?
Name: DisplayLabelWhenAvailable
Typ: bool
Default: True
Beschreibung: Gibt an, ob eine Etikette angezeigt werden soll, falls verfügbar.
Name: DisplayTooltipWhenAvailable
Typ: bool
Default: True
Beschreibung: Gibt an, ob ein Tooltip angezeigt werden soll, falls verfügbar.
Name: DisplayValidationErrorMessage
Typ: bool
Default: True
Beschreibung: Sollte eine Fehlermeldung zur Validierung angezeigt werden, wenn die Komponente die Validierung nicht besteht?
Name: IsVisible
Typ: bool
Default: True
Beschreibung: Ist der Editor sichtbar?
Name: Label
Typ: string?
Beschreibung: Text soll als Etikett für den Editor angezeigt werden.
Name: ReadOnly
Typ: bool?
Beschreibung: Sollte der Editor nur lesegeschützt sein?
Name: RecordContext
Typ: RecordContext
Beschreibung: Bietet Zugang zum inneren LookupRecordContext.RecordContext Gebäude für programmatische Operationen.
Name: Required
Typ: bool?
Beschreibung: Sollte der Wert erforderlich sein.
Name: Value
Typ: LookupValue?
Beschreibung: Der aktuelle Lookup-Wert (Referenz), der von diesem Kontext verwaltet wird.

Veranstaltungen

Name
Typ
Beschreibung
OnBeforeSaveEventCallback<CancelEventArgs>
Callback hat vor dem Speichern angerufen. Ermöglicht das Abbrechen des Speichervorgangs.
ValueChangedEventCallback<ColumnValueBase>
Erhält oder setzt einen Callback, der den gebundenen Wert aktualisiert.
Name: OnBeforeSave
Typ: EventCallback<CancelEventArgs>
Beschreibung: Callback hat vor dem Speichern angerufen. Ermöglicht das Abbrechen des Speichervorgangs.
Name: ValueChanged
Typ: EventCallback<ColumnValueBase>
Beschreibung: Erhält oder setzt einen Callback, der den gebundenen Wert aktualisiert.

Methoden

Name
Parameter
Typ
Beschreibung
GetValidationErrorsList<string>
Gibt eine Sammlung der aktuellen Validierungsfehler zurück.
Name: GetValidationErrors
Typ: List<string>
Beschreibung: Gibt eine Sammlung der aktuellen Validierungsfehler zurück.