RechercheEnregistrementContexte

Le LookupRecordContext composant charge et offre un accès d’édition à l’enregistrement référencé par un champ de recherche sur le parent RecordContext. Il hérite de BaseColumnEdit, donc il se lie à une colonne via le ColumnName paramètre comme tout autre éditeur.

Comment ça fonctionne

Lorsque vous placez un LookupRecordContext dans un RecordContext et spécifiez un ColumnName qui correspond à un champ de recherche, le composant lit automatiquement la valeur de recherche de l’enregistrement parent, récupère l’enregistrement référencé depuis Dataverse, et l’expose comme un fichier imbriqué RecordContext. Tous les éditeurs placés dans la LookupRecordContext liaison des champs du registre consulté.

Nom de la colonne

Le ColumnName paramètre doit se référer à une colonne de recherche sur l’enregistrement parent. Le composant utilise cela pour résoudre la table cible et l’ID de l’enregistrement.

React
Blazor

Modèle de contexte

Par exemple RecordContext, vous pouvez utiliser le ContextTemplate paramètre au lieu de ChildContent pour accéder directement à l’objet recherché TableRecord dans votre balisage.

React
Blazor

Sauvetage

Les modifications apportées aux champs à l’intérieur de un LookupRecordContext sont enregistrées dans le cadre de l’opération de sauvegarde parente MainContext . Le OnBeforeSave rappel peut être utilisé pour exécuter une logique personnalisée ou annuler la sauvegarde.

React
Blazor

Accès programmatique

Cette RecordContext propriété donne accès à l’intérieur RecordContext pour des opérations programmatiques telles que le rafraîchissement ou la vérification de l’état sale.

React
Blazor

Exemple

L’exemple suivant montre un formulaire de compte qui affiche les coordonnées du contact principal en ligne, à l’aide d’une LookupRecordContext liaison au primarycontactid champ de recherche.

Exemple de réaction
Exemple de Blazor
Compte
Contact Primaire
React TypeScript
Razor
Réagir Blazor

LookupRecordContext Classe

Paramètres

Nom
Type
Par défaut
Description
ChildContentRenderFragment?
Contenu enfant du composant
ColumnName*string
Nom logique de colonne pour lier l’éditeur à partir de l’enregistrement de table.
ContextTemplateRenderFragment<TableRecord>
Afficher le fragment qui reçoit l’enregistrement chargé pour affichage ou édition.
Descriptionstring?
Description à afficher dans l’infobulle.
Disabledbool?
Si l’éditeur est désactivé.
DisplayLabelWhenAvailablebool
True
Précise s’il faut afficher une étiquette si disponible.
DisplayTooltipWhenAvailablebool
True
Précise s’il faut afficher une infobulle si disponible.
DisplayValidationErrorMessagebool
True
Un message d’erreur de validation doit-il s’afficher lorsque le composant échoue à la validation ?
IsVisiblebool
True
L’éditeur est-il visible ?
Labelstring?
Le texte doit être affiché comme une étiquette pour l’éditeur.
ReadOnlybool?
L’éditeur devrait-il être en lecture seule ?
RecordContextRecordContext
Fournit l’accès à l’intérieur LookupRecordContext.RecordContext pour les opérations programmatiques.
Requiredbool?
Si la valeur est requise.
ValueLookupValue?
La valeur de recherche actuelle (référence) gérée par ce contexte.
Nom: ChildContent
Type: RenderFragment?
Description: Contenu enfant du composant
Nom: ColumnName*
Type: string
Description: Nom logique de colonne pour lier l’éditeur à partir de l’enregistrement de table.
Nom: ContextTemplate
Type: RenderFragment<TableRecord>
Description: Afficher le fragment qui reçoit l’enregistrement chargé pour affichage ou édition.
Nom: Description
Type: string?
Description: Description à afficher dans l’infobulle.
Nom: Disabled
Type: bool?
Description: Si l’éditeur est désactivé.
Nom: DisplayLabelWhenAvailable
Type: bool
Par défaut: True
Description: Précise s’il faut afficher une étiquette si disponible.
Nom: DisplayTooltipWhenAvailable
Type: bool
Par défaut: True
Description: Précise s’il faut afficher une infobulle si disponible.
Nom: DisplayValidationErrorMessage
Type: bool
Par défaut: True
Description: Un message d’erreur de validation doit-il s’afficher lorsque le composant échoue à la validation ?
Nom: IsVisible
Type: bool
Par défaut: True
Description: L’éditeur est-il visible ?
Nom: Label
Type: string?
Description: Le texte doit être affiché comme une étiquette pour l’éditeur.
Nom: ReadOnly
Type: bool?
Description: L’éditeur devrait-il être en lecture seule ?
Nom: RecordContext
Type: RecordContext
Description: Fournit l’accès à l’intérieur LookupRecordContext.RecordContext pour les opérations programmatiques.
Nom: Required
Type: bool?
Description: Si la valeur est requise.
Nom: Value
Type: LookupValue?
Description: La valeur de recherche actuelle (référence) gérée par ce contexte.

Événements

Nom
Type
Description
OnBeforeSaveEventCallback<CancelEventArgs>
Rappel a appelé avant de sauvegarder. Cela permet d’annuler l’opération de sauvegarde.
ValueChangedEventCallback<ColumnValueBase>
Obtient ou définit un callback qui met à jour la valeur liée.
Nom: OnBeforeSave
Type: EventCallback<CancelEventArgs>
Description: Rappel a appelé avant de sauvegarder. Cela permet d’annuler l’opération de sauvegarde.
Nom: ValueChanged
Type: EventCallback<ColumnValueBase>
Description: Obtient ou définit un callback qui met à jour la valeur liée.

Méthodes

Nom
Paramètres
Type
Description
GetValidationErrorsList<string>
Retourne une collection des erreurs de validation courantes.
Nom: GetValidationErrors
Type: List<string>
Description: Retourne une collection des erreurs de validation courantes.