DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Syntaxe WLangage / Procédures WLangage
  • Présentation
  • Procédures d'une collection
  • Méthodes d'une classe
  • Procédures d'un champ
  • Tableau récapitulatif
  • Modifications de la portée
  • Modifier la portée d'une procédure
  • Passage d'un projet issu d'une ancienne version vers la version 28 ou supérieure
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
Présentation
La portée d'une procédure définit si elle est publique, privée, etc. Cette page présente les différences des types de portée possibles selon le type de procédure utilisé et leurs conséquences sur votre code.
La portée des procédures peut concerner :
  • Les procédures d'une collection de procédures.
  • Les méthodes d'une classe.
  • Les procédures d'un champ.
Procédures d'une collection
Lors de la création d'une procédure, différentes visibilités sont possibles :
Par défaut, la procédure est "Publique".
Trois cas sont possibles :
  • Procédure publique : La procédure sera utilisable depuis n'importe que traitement ou événement du projet.
    Dans le cas d'un projet permettant de générer un Webservice SOAP, cette procédure publique sera exportée dans le Webservice (la procédure est un point d'entrée visible du Webservice).
  • Procédure privée : La procédure n'est pas utilisable depuis un autre élément du projet (collections de procédures, fenêtres, ...).
    Dans le cas d'un projet permettant de générer un Webservice, cette procédure privée ne sera pas exportée dans le Webservice.
    La procédure peut être appelée uniquement depuis la collection de procédures dans laquelle elle est définie.
  • Procédure restreinte : La procédure sera utilisable dans tout le projet mais sans être exportée dans un Webservice ou un composant externe.
Méthodes d'une classe
Lors de la création d'une méthode de classe, différentes visibilités sont possibles :
Par défaut, une méthode de classe est "Publique".
Plusieurs cas sont possibles :
  • Méthode publique : la méthode de classe est accessible depuis n'importe quel élément du projet et elle est exportée lors de la génération d'un composant externe ou d'un Webservice SOAP.
  • Méthode restreinte : la méthode de classe reste utilisable dans tous les éléments du projet mais elle n'est pas exportée dans les composants externes ou dans les Webservices SOAP.
  • Méthode protégée : la méthode est accessible à l'intérieur du code de la classe et des classes dérivées uniquement. La méthode est exportée lors de la génération d'un composant externe ou d'un Webservice SOAP.
  • Méthode protégée restreinte : la limitation est identique à la portée "protégée", mais la méthode ne sera pas exportée lors d'une génération de composant externe ou de Webservice SOAP.
  • Méthode privée : la méthode est accessible uniquement à l'intérieur du code de la classe courante.
Procédures d'un champ
Les champs peuvent contenir des procédures locales au champ (fonctionnalité utilisée par exemple par les Champs Métier livrés dans le produit). Ces procédures peuvent être publiques ou privées.
Une procédure privée sera utilisable uniquement dans le champ auquel elle appartient. Cela permet par exemple d'isoler le code et d'éviter des appels abusifs : un champ A ne pourra pas appeler une procédure d'un champ B.
Tableau récapitulatif
PubliqueRestreintePrivée
Accès depuis l'élémentOuiOuiOui
Accès depuis un autre élément du projetOuiOuiNon
Accès depuis un projet tiers via un Webservice SOAP ou un composant externeOuiNonNon
Modifications de la portée

Modifier la portée d'une procédure

La portée d'une procédure ou d'une méthode peut être modifiée à tout moment :
  • soit en écrivant directement la nouvelle portée dans le code de la procédure ou de la méthode,
  • soit en effectuant un clic droit sur l'élément dans le volet "Explorateur du projet" et en cochant la visibilité souhaitée.
Dans le volet "Explorateur de projet", la portée de la procédure ou de la méthode peut être identifiée via la couleur du picto :
  • les éléments privés en rouge,
  • les éléments protégés en orange,
  • les éléments publics en vert.

Passage d'un projet issu d'une ancienne version vers la version 28 ou supérieure

Pour les projets issus d'une ancienne version (version 27 et antérieures), une nouvelle erreur de compilation liée au changement de comportement du mot-clé "PRIVÉ" peut apparaître lors du passage en version 28. En effet, avant la version 28, le mot-clé "Privé" avait pour le même effet que le mot-clé "Restreint" actuel. Lors du passage en version 28, il peut donc être nécessaire de remplacer le mot-clé "Privé" par le mot-clé "Restreint". Une erreur de compilation vous aide à détecter les différents cas dans votre projet.
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 20/10/2023

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