DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Propriétés WLangage / Propriétés HFSQL
  • Comment savoir si un fichier de données supporte la gestion de la valeur NULL ?
  • Limites
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
La propriété Null permet de gérer la valeur NULL dans les rubriques des fichiers de données HFSQL ou dans les rubriques des fichiers de données accédés par les Connecteurs Natifs.
Cette propriété permet de :
  • Affecter NULL à la rubrique pour l'enregistrement en cours.
  • Savoir si la rubrique est associée à la valeur NULL pour l'enregistrement en cours.
  • Définir la valeur par défaut d'une rubrique lors de la description d'un fichier de données par programmation. Il est également possible d'utiliser la propriété ValeurParDéfaut.
Nouveauté 2024
Gestion des valeurs nullables : Si l'option "Autoriser les types nullables" est cochée dans la description du projet, cette propriété n'est plus nécessaire pour connaître ou modifier la valeur de la rubrique. En effet, cette option permet de :
  • réaliser une affectation directe d'une rubrique HFSQL avec la valeur Null en utilisant la syntaxe :
    Fichier.Rubrique = Null
  • savoir si une rubrique HFSQL contient la valeur Null en utilisant la syntaxe :
    SI Fichier.Rubrique = Null ALORS
    ...
    FIN
Pour plus de détails, consultez Gestion de la valeur NULL : Autoriser les types nullables.
Exemple
// Affecter NULL à la rubrique Client.Portable
Client.Portable.Null = Vrai
Syntaxe

Savoir si la rubrique est associée à la valeur NULL Masquer les détails

<Résultat> = <Fichier de données>.<Rubrique>.Null
<Résultat> : Booléen
  • Vrai si la rubrique associée à l'enregistrement en cours a pour valeur NULL,
  • Faux dans le cas contraire.
<Fichier de données> : Chaîne de caractères
Nom logique du fichier de données manipulé. Ce nom a été défini sous l'éditeur d'analyses ou grâce au type Description de Fichier.
<Rubrique> : Chaîne de caractères
Nom de la rubrique manipulée.
Universal Windows 10 AppiPhone/iPadWidget IOS

Affecter NULL à une rubrique Masquer les détails

<Fichier de données>.<Rubrique>.Null = <Valeur nulle>
<Fichier de données> : Chaîne de caractères
Nom logique du fichier de données manipulé. Ce nom a été défini sous l'éditeur d'analyses ou grâce au type Description de Fichier.
<Rubrique> : Chaîne de caractères
Nom de la rubrique manipulée.
<Valeur nulle> : Booléen
  • Vrai pour affecter NULL à la rubrique spécifiée pour l'enregistrement en cours.
  • Faux dans le cas contraire.
Universal Windows 10 AppiPhone/iPadWidget IOS

Définir la valeur par défaut d'une rubrique d'un fichier défini par programmation Masquer les détails

<Fichier de données>.<Rubrique>.Null = <Valeur nulle>
<Fichier de données> : Chaîne de caractères
Nom logique du fichier de données manipulé. Ce nom vient d'être défini grâce au type Description de Fichier.
<Rubrique> : Chaîne de caractères
Nom de la rubrique manipulée.
<Valeur nulle> : Booléen
  • Vrai si la valeur par défaut de la rubrique doit être nulle,
  • Faux dans le cas contraire.
Remarques

Comment savoir si un fichier de données supporte la gestion de la valeur NULL ?

  • Pour savoir si un fichier de données autorise ou non la gestion de la valeur NULL, utilisez la propriété NullSupporté.
  • Pour savoir si une rubrique autorise ou non la gestion de la valeur NULL, utilisez la propriété NullAutorisé.
Attention :
  • L'affectation de la propriété Null sur un fichier de données ou une rubrique qui ne supporte pas la gestion de la valeur NULL est interdite : une erreur fatale est affichée.
  • La consultation de la propriété Null sur un fichier de données ou une rubrique qui ne supporte pas la gestion de la valeur NULL renvoie toujours Faux.

Limites

  • Il n'est pas possible d'utiliser la valeur NULL :
    • sur les rubriques tableau.
    • sur les identifiants automatiques.
    • sur les clés composées.
  • Il n'est pas possible d'affecter la valeur NULL plusieurs fois à une rubrique prenant en compte la gestion des doublons.
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 29/02/2024

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