DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions de gestion des fichiers XML
  • Cas particuliers
  • Assistant de code
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
Renvoie la valeur d'un élément XML ou la valeur de l'attribut d'un élément XML.
Exemple
MonDoc est une chaîne = fChargeTexte("exemple.xml")
XMLDocument("DOM", MonDoc)
sNomFonction est une chaîne = XMLLit("DOM","/Exemple/Aide/Fonction")
sTypeFonction est une chaîne = XMLLit("DOM","Aide/Fonction/@type")
sNomFonction2 est une chaîne = XMLLit("DOM","Aide/Fonction[2]")
sImage est une chaîne = XMLLit("DOM","Aide[2]/@image")
sTypeImage est une chaîne = XMLLit("DOM","/Exemple/Aide[@image=""trait.jpg""]/@format", "NonDefini")
XMLTermine("DOM")
// S'applique au document XML suivant:
// <Exemple>
// <Aide>
// <Fonction type="1">Lire</Fonction>
// <Fonction>Ecrire</Fonction>
// </Aide>
// <Aide image="trait.jpg" format="jpg" />
// </Exemple>
Syntaxe
<Résultat> = XMLLit(<Document XML> , <Chemin de l'élément à lire> [, <Non trouvé>])
<Résultat> : Chaîne de caractères
  • Valeur de l'élément ou de l'attribut,
  • Chaîne vide ("") ou la valeur du paramètre <Non trouvé> dans les cas suivants :
    • si l'élément n'a pas été trouvé.
    • si l'élément n'a pas de valeur
    • si la requête XPath n'est pas une requête de sélection d'enregistrements.
      Dans ce cas, la variable ErreurDétectée est à Vrai et la fonction ErreurInfo permet d'obtenir plus de détails sur l'erreur.
<Document XML> : Chaîne de caractères
Nom du document XML dans lequel la lecture doit être effectuée. Ce document contient le code XML à analyser et a été créé avec la fonction XMLDocument.
<Chemin de l'élément à lire> : Chaîne de caractères
Peut correspondre :
  • au chemin dans le XML de la valeur à lire. Attention : la casse utilisée est prise en compte (minuscules et majuscules). Pour lire la valeur d'un attribut, il suffit de faire précéder le nom de l'attribut par le caractère "@".
  • au texte d'une requête XPath à exécuter. La requête XPath doit être de type "sélection d'enregistrements". Si plusieurs éléments répondent à la sélection, le premier trouvé est utilisé.
Si ce chemin ne commence pas par "/", le nom du noeud racine est automatiquement ajouté. Si le document XML n'a pas de racine, <Résultat> correspond à <Non trouvé>.
<Non trouvé> : Chaîne de caractères optionnelle
Texte à renvoyer si l'élément n'a pas été trouvé. Par défaut, ce paramètre correspond à une chaîne vide ("").
Remarques

Cas particuliers

  • La fonction XMLLit ne modifie pas la position courante dans le document.
  • Il n'est pas possible d'imbriquer plusieurs requêtes XML de parcours.
  • La fonction XMLLit ne doit pas être utilisée avec une variable de type XMLDocument. Pour lire le contenu d'une variable de type XMLDocument, utilisez la syntaxe "POUR TOUT".
WEBDEV - Code Serveur

Assistant de code

L'éditeur de code propose un assistant de code permettant de générer le code de la fonction XMLLit. Pour l'utiliser, tapez "XMLLit(" sous l'éditeur de code puis sélectionnez l'option "Assistant de la fonction XMLLit".
Classification Métier / UI : Code métier
Composante : wd290xml.dll
Version minimum requise
  • Version 12
Documentation également disponible pour…
Commentaires
CDATA
A noter : Si le contenu Xml est indiqué comme étant un CDATA :
<url><![CDATA[https://MonTest.fr?key=Test&_edit=123456]]></url>
La fonction XmlLit retourne vide, c'est normal
Pour récupérer le contenu, il faut utiliser XMLExtraitChaîne
Emmanuel LANGUEBIEN
26 mai 2023

Dernière modification : 25/05/2022

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