LiaisonDonnées (Propriété)

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

Version :

Accueil | Connexion | Français (générique)

Aide / WLangage / Propriétés WLangage / Propriétés des fenêtres, des pages et de leurs champs

Champ Liste image
Erreur d'affichage
Limites

WINDEV

WEBDEV

WINDEV Mobile

Autres

Voir Aussi

LiaisonDonnées (Propriété)

En anglais : DataBinding

Avertissement
A partir de la version 26, FileLink is kept for backward compatibility. This property has been replaced with LiaisonDonnées.

La propriété LiaisonDonnées permet de connaître et de modifier la liaison d'un champ:

avec une rubrique d'une table.
avec une variable.
avec plusieurs variables (dans ce cas, chaque variable peut être reliée à une propriété différente du champ).

Rappel: La liaison d'un champ avec une rubrique ou une variable est normalement définie sous l'éditeur de fenêtres ou de pages, lors de la description du champ (onglet "Liaison"). Cette liaison permet d'indiquer la rubrique de la table qui sera utilisée lors de l'utilisation des fonctions de synchronisation (EcranVersFichier, FenêtreVersSource, PageVersDonnées, PageVersSource, DonnéesVersFenêtre, DonnéesVersPage, SourceVersFenêtre, SourceVersPage).

Un champ peut être lié à une rubrique d'une table de base, ou à une rubrique d'une table reliée (on parle alors de liaison complexe ou de liaison multi-tables). Exemple de liaison multi-table:

Onglet 'Liaison' de la description d'un champ

Cette propriété est équivalente à la fonction ChampAlias.

Exemple

// Relie le champ SAI_Saisie1 avec la rubrique Nom de la table Client
SAI_Saisie1.LiaisonDonnées = "Client.Nom"
// Idem, mais à partir de la table Commande avec 1 liaison
SAI_Saisie2.LiaisonDonnées = "Commande.IDClient" + TAB + "Client.IDClient:Nom"
// Idem, mais à partir de la table LigneCmd avec 2 liaisons
SAI_Saisie3.LiaisonDonnées = "LigneCmd.IDCmd" + TAB + ...
		"Commande.IDCmd:IDClient" + TAB + "Client.IDClient:Nom"
// Relie le champ Table TABLE_Table1 avec le tableau Tableau_Mois
TABLE_Table1.LiaisonDonnées = ":Tableau_Mois"
// Mise à jour à l'écran
FichierVersEcran()

// A chaque appel de la fonction SourceVersEcran, le champ SAI_EnCours_Autorisé aura: 
// - sa valeur affichée mise à jour par la propriété EnCoursAutorisé d'une instance de classe,
// - une couleur de fond affectée par la valeur d'une variable globale
gclContact est un cContact
gsCouleur est un entier = BleuPastel
SAI_EnCours_Autorisé.LiaisonDonnées = ":gclContact.EnCoursAutorisé" + TAB + ...
	"valeur" + RC + ":gsCouleur" + TAB + "CouleurFond"
// Mise à jour à l'écran
SourceVersEcran()

Syntaxe

Connaître la liaison d'un champ avec une rubrique ou une variable Masquer les détails

<Liaison actuelle> = <Champ manipulé>.LiaisonDonnées

<Liaison actuelle> : Chaîne de caractères

Différents types de liaisons peuvent être trouvés:
Aucune liaison: chaîne vide ("")
Liaison simple avec une rubrique d'une table:
"<Table de base>.<Rubrique de base>"
Liaison complexe avec une rubrique d'une table:
"<Fichier de données de base>.<Rubrique de base>[ + TAB + <Liaison> [+ TAB + <Liaison>]]"

où <Liaison> correspond à:
<Table reliée>.<Clé>:<Rubrique reliée>[<Indice>]
Liaison avec une variable:
":<préfixe><Nom de la variable>"
ou bien
":<Nom de la variable>"
(le préfixe est présent uniquement si la charte de programmation est activée dans le projet).

<Champ manipulé> : Nom de champ

Nom du champ dont on veut connaître la liaison aux données.

Modifier la liaison d'un champ avec une rubrique ou une variable Masquer les détails

<Champ manipulé>.LiaisonDonnées = <Nouvelle liaison>

<Champ manipulé> : Nom de champ

Nom du champ dont on veut modifier la liaison aux données.

<Nouvelle liaison> : Chaîne de caractères

Différents types de liaisons peuvent être définis:
Aucune liaison: chaîne vide ("")
Liaison simple avec une rubrique d'une table:
"<Table de base>.<Rubrique de base>"
Liaison complexe avec une rubrique d'une table:
"<Fichier de données de base>.<Rubrique de base>[ + TAB + <Liaison> [+ TAB + <Liaison>]]"

où <Liaison> correspond à:
<Table reliée>.<Clé>:<Rubrique reliée>[<Indice>]
Remarque: la syntaxe suivante est également autorisée:
<[Table de base>.<Rubrique>[<[Indice]>] [: <Liaison> [: <Liaison>] ]

avec <Liaison> = <Table reliée>.<Clé>:<Rubrique affichée> [<[Indice]>]
Liaison avec une variable:
":<préfixe><Nom de la variable>"
ou bien
":<Nom de la variable>"
Le préfixe doit être précisé si la charte de programmation est activée dans le projet (que les préfixes soient affichés ou non).
Liaison avec une variable de type source de données:
<Nom de la variable>.Nom + ".<Rubrique de base>"
Liaison de plusieurs propriétés avec plusieurs variables: la chaîne de caractères décrivant la liaison doit être de la forme:
":" + <Nom de la variable 1> + TAB + <Nom de la propriété 1> + RC + ...
":" + <Nom de la variable 2> + TAB + <Nom de la propriété 2> + RC + ...
":" + <Nom de la variable N> + TAB + <Nom de la propriété N>