DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions de gestion des fichiers XML
  • Connaître l'élément courant
  • Fonctions XML et threads
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 de l'élément en cours (balise ou attribut XML) ou d'un de ses attributs.
Pour sélectionner un élément, utilisez les fonctions de recherche et de parcours XML (XMLPremier, XMLDernier, XMLFils, ...).
Exemple
// Valeur de l'attribut "Produit" de l'élément en cours
Valeur est une chaîne
Valeur = XMLDonnée("DocXML", "Produit")
 
// Test de la valeur
SI Valeur = "" ALORS
Erreur("L'attribut Produit n'a pas de valeur")
SINON
Info("La valeur de l'attribut Produit est : " + Valeur)
FIN
WINDEVWEBDEV - Code ServeurEtats et RequêtesUniversal Windows 10 AppJavaCode Utilisateur (MCU)PHPAjax
// Valeur d'une balise
Valeur est une chaîne
Valeur = XMLDonnée("DocXML")
 
// Positionné sur une balise ?
SI ErreurDétectée = Vrai ALORS
Erreur(ErreurInfo())
SINON
// Test de la valeur
SI Valeur = "" ALORS
Erreur("L'élément en cours n'a pas de valeur")
SINON
Info("La valeur de l'élément courant est : " + Valeur)
FIN
FIN
Syntaxe
<Résultat> = XMLDonnée(<Document XML> [, <Attribut> [, <Mode de recherche>]])
<Résultat> : Chaîne de caractères
  • Valeur de l'élément en cours ou de l'attribut spécifié.
  • Chaîne vide ("") :
    • si l'élément en cours n'a pas de valeur.
    • si l'élément en cours n'a pas pour fils l'attribut spécifié.
    • si aucun élément n'est en cours. Dans ce cas, la variable ErreurDétectée est à Vrai. Pour obtenir plus de détails sur l'erreur, utilisez la fonction ErreurInfo.
    • si l'élément en cours est déjà un attribut. Dans ce cas, la variable ErreurDétectée est à Vrai. Pour obtenir plus de détails sur l'erreur, utilisez la fonction ErreurInfo.
<Document XML> : Chaîne de caractères
Nom du document XML manipulé. Ce document contient le code XML à analyser et a été créé avec la fonction XMLDocument.
<Attribut> : Chaîne de caractères optionnelle
Nom de l'attribut fils de la balise en cours pour lequel la valeur doit être renvoyée. Cet attribut est recherché parmi les fils directs de l'élément en cours. Si ce paramètre n'est pas précisé (ou correspond à Null ou chaîne vide), la fonction XMLDonnée renvoie la valeur de la balise en cours.
<Mode de recherche> : Constante optionnelle de type Entier
Mode de recherche de l'attribut parmi les fils de l'élément en cours.
XMLCommenceParRecherche du premier attribut dont le nom commence par le contenu du paramètre <Attribut>.
XMLContientRecherche du premier attribut dont le nom contient la valeur du paramètre <Attribut>.
XMLExact
(Valeur par défaut)
Recherche du premier attribut dont le nom correspond exactement à la valeur du paramètre <Attribut>.
XMLIgnoreLaCasseRecherche du premier attribut dont le nom correspond à la valeur du paramètre <Attribut> en ignorant la casse.
Peut être combiné avec les constantes XMLContient, XMLCommencePar ou XMLExact.
Remarques

Connaître l'élément courant

  • Le type de l'élément courant peut être connu avec la fonction XMLTypeElément.
  • Le nom de l'élément courant peut être connu avec la fonction XMLNomElément.

Fonctions XML et threads

Si votre application utilise des threads, le document XML est partagé entre tous ces threads. Pour plus de détails sur la gestion des threads, consultez Gestion des threads.
Composante : wd300xml.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Attention ne fonctionne pas avec CDATA
Ne sait pas gérer les données protegées par <![CDATA[donnée]]>
Retoure une chaine vide.
C'est dommage.
roland
03 nov. 2012

Dernière modification : 25/05/2022

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