DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Champs, pages et fenêtres / Fonctions Table
  • Conditions d'utilisation
  • Caractéristiques d'une ligne
  • Champ Table/Table hiérarchique fichier : Modifications dans le fichier de données lié
  • Modifications réalisées dans un champ Table/Table hiérarchique fichier
  • Modification dans un champ Table fichier et déclenchement d'un trigger
  • Fonction TableModifie et propriété Modifié
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Modifie une ligne dans :
  • un champ Table,
  • un champ Table hiérarchique,
  • WINDEV une table affichée dans un champ Combo.
Remarque : Il est conseillé d'utiliser la fonction TableModifieLigne. La fonction TableModifieLigne permet d'ajouter :
  • des caractères TAB dans les colonnes,
  • des valeurs de n'importe quel type dans les colonnes.
Exemple
// Modification des éléments "Paul" et "Dubois" de la cinquième
// ligne du champ "TABLE_TableClient"
TableModifie(TABLE_TableClient, "Paul" + TAB + "Dubois", 5)
// Modification dans une colonne d'un champ Table
TableModifie(COL_NOM, "Dubois", 5)
Syntaxe
TableModifie(<Champ Table> , <Ligne> [, <Indice>])
<Champ Table> : Nom de champ
Nom du champ à manipuler. Ce champ peut correspondre à :
  • un champ Table.
  • un champ Table hiérarchique.
  • WINDEV un champ Combo avec table.
Si ce paramètre correspond à une chaîne vide (""), le champ manipulé sera le champ auquel appartient l'événement en cours.
<Ligne> : Chaîne de caractères
Ligne modifiée remplaçant la ligne spécifiée. Cette ligne est de la forme :
<Elément de la colonne 1> + TAB + <Elément de la colonne 2> + TAB + ...
<Indice> : Entier optionnel
Indice de la ligne à modifier. La première ligne a pour valeur 1.
Indice non précisé ou égal à -1La ligne en cours est modifiée. Cette constante n'a aucun effet si aucune ligne n'est sélectionnée.
Indice supérieur au nombre de lignes du champUne erreur du WLangage est générée.
Remarques

Conditions d'utilisation

La fonction TableModifie peut être utilisée indifféremment sur :
  • un champ Table ou Table hiérarchique fichier.
  • un champ Table ou Table hiérarchique par programmation.
  • un champ monosélection ou multisélection.
    WEBDEV - Code ServeurPHP Rappel : La multisélection n'est pas disponible sur les champs Table classique.
WEBDEV - Code ServeurPHP Cette fonction est disponible pour les champs Table en mode "Serveur + AJAX", les champs Table en mode "Serveur" et les champs Table hiérarchique.
WEBDEV - Code Navigateur Cette fonction est disponible uniquement pour les champs Table en mode "Navigateur".
WEBDEV - Code Navigateur Le champ Table hiérarchique n'est pas disponible.
AndroidiPhone/iPad Les champs Table fichier ne sont pas disponibles en saisie. La fonction TableModifie ne peut pas être utilisée sur un champ Table fichier.

Caractéristiques d'une ligne

  • Chaque élément de la ligne est converti dans le type de la colonne associée.
  • Si un des éléments correspond à une chaîne vide ("") ou à 0 (selon le type de la colonne), sa valeur sera écrasée.
    Par exemple :
    TableModifie(TABLE_TableClient, "Dubois" + TAB + "Pierre" + TAB + "" + ...
    TAB + "21/06/72")
  • Si un élément correspond au résultat d'un calcul, il faut mettre l'expression numérique entre parenthèses.
    Par exemple :
    TableModifie(TABLE_TableCalcul, (53+29) + TAB + (83-21))
  • Pour modifier uniquement la valeur d'un élément dans une ligne, utilisez la syntaxe suivante :
    NomTable.NomColonne[IndiceLigne] = NouvelleValeur
WINDEVWEBDEV - Code ServeurJavaPHP

Champ Table/Table hiérarchique fichier : Modifications dans le fichier de données lié

Si la saisie en cascade est activée, le fichier de données lié au champ est automatiquement modifié lorsque l'utilisateur passe à la ligne suivante.
Si la saisie en cascade n'est pas activée, le fichier de données lié au champ n'est pas modifié. Pour écrire l'enregistrement dans le fichier de données lié, il est nécessaire d'utiliser la fonction TableEnregistre après la fonction TableModifie.
Remarques :
  • L'option "Saisie en cascade" peut être sélectionnée dans l'onglet "Détail" de la fenêtre de description du champ.
  • Java La saisie en cascade n'est pas disponible sur les champs Table fichier à accès direct. Cette option est disponible uniquement sur les champs Table par programmation et sur les champs Table fichier chargé en mémoire.
  • WEBDEV - Code Serveur La saisie en cascade est disponible uniquement sur les champs Table fichier en mode "Serveur + AJAX".

Modifications réalisées dans un champ Table/Table hiérarchique fichier

Pour modifier une ligne d'un champ Table/Table hiérarchique fichier, il est conseillé de :
  • modifier directement l'enregistrement dans le fichier de données avec la fonction HModifie,
  • utiliser la fonction TableAffiche pour ré-actualiser le champ.
WINDEVWEBDEV - Code ServeurJavaCode Utilisateur (MCU)

Modification dans un champ Table fichier et déclenchement d'un trigger

Il est possible de déclencher un trigger lors de la modification d'un enregistrement dans un champ Table fichier. Pour plus de détails, consultez la documentation de la fonction HDécritTrigger.
WINDEVJava

Fonction TableModifie et propriété Modifié

La fonction TableModifie n'a aucune influence sur la propriété Modifié. La propriété Modifié permet de savoir si la ligne en cours a été modifiée directement par l'utilisateur (saisie directe dans le champ).
Composante : wd290obj.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 14/06/2022

Signaler une erreur ou faire une suggestion | Aide en ligne locale