PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE


  • Conditions d'utilisation
  • Suppression dans un champ Table ou Table hiérarchique fichier
  • Intégrité référentielle et champ Table ou Table hiérarchique fichier
  • Suppression dans un champ Table fichier et Trigger
  • Gestion des erreurs
  • Blocage du fichier de données lié
  • Suppression dans un champ Table mémoire avec un filtre de type "Contient"
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget iOSApple WatchCatalystUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
Supprime une ligne dans :
  • un champ Table,
  • un champ Table hiérarchique,
  • WINDEVWindows Mobile une table affichée dans un champ Combo.
Versions 22 et supérieures
WINDEV Remarque : Pour supprimer une ligne avec une animation, utilisez la fonction TableSupprimeAvecAnimation.
Nouveauté 22
WINDEV Remarque : Pour supprimer une ligne avec une animation, utilisez la fonction TableSupprimeAvecAnimation.
WINDEV Remarque : Pour supprimer une ligne avec une animation, utilisez la fonction TableSupprimeAvecAnimation.
Versions 16 et supérieures
Linux Cette fonction est désormais disponible pour les applications WINDEV sous Linux.
Nouveauté 16
Linux Cette fonction est désormais disponible pour les applications WINDEV sous Linux.
Linux Cette fonction est désormais disponible pour les applications WINDEV sous Linux.
Versions 18 et supérieures
WEBDEV - Code ServeurPHP Cette fonction permet désormais de manipuler les champs Table hiérarchique dans les sites WEBDEV et PHP.
Nouveauté 18
WEBDEV - Code ServeurPHP Cette fonction permet désormais de manipuler les champs Table hiérarchique dans les sites WEBDEV et PHP.
WEBDEV - Code ServeurPHP Cette fonction permet désormais de manipuler les champs Table hiérarchique dans les sites WEBDEV et PHP.
Versions 19 et supérieures
WEBDEV - Code Navigateur Cette fonction est désormais disponible en code Navigateur pour les champs Table en mode navigateur.
Nouveauté 19
WEBDEV - Code Navigateur Cette fonction est désormais disponible en code Navigateur pour les champs Table en mode navigateur.
WEBDEV - Code Navigateur Cette fonction est désormais disponible en code Navigateur pour les champs Table en mode navigateur.
Versions 20 et supérieures
Android Cette fonction est désormais disponible pour les applications Android.
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Nouveauté 20
Android Cette fonction est désormais disponible pour les applications Android.
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Android Cette fonction est désormais disponible pour les applications Android.
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Exemple
// Suppression de la ligne 5 dans le champ "TABLE_Produit"
TableSupprime(TABLE_Produit, 5)
// Supprimer toutes les lignes sélectionnées dans un champ Table
// A partir de la version 18, la fonction TableSupprimeSelect est disponible
i est un entier
NbSelection est un entier = TableSelectOccurrence(TABLE_MaTable)
POUR i = NbSelection A 1 PAS -1
TableSupprime(TABLE_MaTable, TableSelect(TABLE_MaTable, i))
FIN
Syntaxe
TableSupprime(<Champ Table> [, <Indice>])
<Champ Table> : Nom de champ
Nom du champ à manipuler. Ce champ peut correspondre à :
  • un champ Table.
  • un champ Table hiérarchique.
  • WINDEVWindows Mobile un champ Combo avec table.
Si ce paramètre correspond à une chaîne vide (""), le champ Table manipulé sera celui auquel appartient l'événement en cours.
<Indice> : Entier optionnel
Indice de la ligne à supprimer.
Si ce paramètre n'est pas précisé, la ou les lignes sélectionnées sont supprimées. Si ce paramètre n'est pas précisé et si aucune ligne n'est sélectionnée, la fonction TableSupprime n'a aucun effet.
Remarques

Conditions d'utilisation

La fonction TableSupprime peut être utilisée sur :
  • un champ fichier ou mémoire.
  • un champ monosélection ou multisélection.
    WEBDEV - Code ServeurPHP Rappel : Les champs multisélections sont disponibles uniquement en Ajax. WEBDEV - Code ServeurPHP Rappel : La multisélection n'est pas disponible sur les champs Table en mode classique.
WEBDEV - Code ServeurPHP Cette fonction est disponible pour les champs Table en mode Ajax, les champs Table en mode classique et les champs Table hiérarchique.
WEBDEV - Code Navigateur Cette fonction est disponible uniquement pour les champs Table en mode navigateur.
WEBDEV - Code NavigateurAndroidiPhone/iPad Le champ Table hiérarchique n'est pas disponible.

Suppression dans un champ Table ou Table hiérarchique fichier

La fonction TableSupprime supprime l'enregistrement correspondant dans le fichier de données associé au champ. Si des rubriques sont reliées à d'autres fichiers de données, aucune modification n'est effectuée automatiquement sur ces fichiers de données liés.

Intégrité référentielle et champ Table ou Table hiérarchique fichier

Si la gestion de l'intégrité référentielle est active (fonction HGèreIntégrité), testez la fonction HErreurIntégrité après l'appel de la fonction TableSupprime pour vérifier l'intégrité.
Si une erreur d'intégrité est détectée, la ligne n'est pas supprimée et reste visible dans le champ.

Suppression dans un champ Table fichier et Trigger

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

Gestion des erreurs

En cas d'échec de la suppression, la variable ErreurDétectée est à Vrai. Pour plus de détails sur l'erreur, il est possible d'utiliser la fonction ErreurInfo.
Exemple de cas d'erreur : Suppression d'une ligne dont l'indice correspond à une ligne non sélectionnée dans la partie visible du champ Table.

Blocage du fichier de données lié

Si le fichier de données est bloqué dans le traitement en cours, la fonction TableSupprime supprime la ligne spécifiée et débloque le fichier de données.

Suppression dans un champ Table mémoire avec un filtre de type "Contient"

La fonction TableSupprime utilisée sur un champ Table mémoire utilisant un filtre de type "Contient" fait apparaît des enregistrements qui ne correspondent pas au filtre. Les filtres définis par les FAA (Fonctionnalités Automatiques de vos Applications) sont annulés.
Composante : wd250obj.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire