PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

  • Cas particuliers
  • Assistant de code
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
Renvoie la valeur d'un élément XML ou la valeur de l'attribut d'un élément XML.
Versions 15 et supérieures
PHP Cette fonction est désormais disponible pour les sites PHP.
Nouveauté 15
PHP Cette fonction est désormais disponible pour les sites PHP.
PHP Cette fonction est désormais disponible pour les sites PHP.
Versions 17 et supérieures
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Nouveauté 17
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Versions 18 et supérieures
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Nouveauté 18
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Versions 21 et supérieures
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Nouveauté 21
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
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 (avec guillemets)
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 (entre guillemets)
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 (entre guillemets) 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".
WINDEVWEBDEV - Code ServeurWINDEV Mobile

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".
Composante : wd240xml.dll
Version minimum requise
  • Version 12
Documentation également disponible pour…
Commentaires
Lire un CDATA
si je veux lire un CDATA dans une balise, il faut utiliser la fonction XPath /text(), exemple :
<exemple>
<aide><![CDATA[test]]></aide>
</exemple>
[...]
sMonTexte est une chaine = XMLLit("DOM","Aide/text()")
M
19 sep. 2017