DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions de gestion des fichiers XML
  • Rappel : Langage XML
  • Fonctions XML et threads
  • Limite
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
XMLDocument (Fonction)
En anglais : XMLDocument
Crée un nouveau document XML. Ce document peut être :
  • un document vide. Il peut être complété grâce aux fonctions XMLAjouteAttribut, XMLAjouteFils, ...
  • un document contenant le code XML à manipuler avec les fonctions XML du WLangage. Ce code peut provenir d'un fichier au format XML ou d'un Webservice. L'élément en cours correspond automatiquement à la balise racine (la racine n'est pas créée si elle n'existe pas). Ce document pourra être fermé avec la fonction XMLTermine.
Remarque : La fonction XMLDocument ne manipule pas un fichier mais un code XML.
SourceXML est une chaîne
Res est un booléen
// Création du document XML
Res = XMLDocument("DocXML", SourceXML)
// Le document est créé ?
SI Res = Faux ALORS
Erreur("Le document n'a pas pu Ãªtre créé.")
SINON
Info("Le document a bien Ã©té créé. Il est prêt Ã  Ãªtre utilisé.")
FIN
// Modification du document
...
WINDEVUniversal Windows 10 AppJavaCode Utilisateur (MCU)
SourceXML est une chaîne
Res est un booléen
// Chargement du contenu XML
SourceXML = fChargeTexte("C:\Temp\exemple.xml")
// Création du document XML
Res = XMLDocument("DocXML", SourceXML)
// Le document est créé ?
SI Res = Faux ALORS
Erreur("Le problème suivant a Ã©té détecté : " + ErreurInfo())
SINON
Info("Le document a bien Ã©té créé. Il est prêt Ã  Ãªtre utilisé.")
FIN
// Modification du document
...
// Reconstruction de la chaîne XML
SourceXML = XMLConstruitChaîne("DocXML")
// Sauvegarde du document XML dans un fichier
fSauveTexte("C:\Temp\ExempleModifié.xml", SourceXML)
Syntaxe
<Résultat> = XMLDocument(<Document XML> [, <Code XML> [, <Option>]])
<Résultat> : Booléen
  • Vrai si le document XML est créé,
  • Faux dans le cas contraire. En cas d'erreur :
    • la position courante reste inchangée.
    • 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 donné au document XML. Ce nom sera utilisé par toutes les fonctions XML.
<Code XML> : Chaîne de caractères optionnelle
Code XML à analyser avec les fonctions XML. Si ce paramètre n'est pas précisé, un nouveau document XML vide est créé.
Attention :
  • Si l'encodage du document n'est pas précisé dans l'entête XML, l'encodage utilisé est "UTF-8".
  • Pour spécifier un encodage différent, il suffit d'ajouter l'attribut "encoding" à la balise XML.
    Par exemple : <?xml version="1.0" encoding="UCS-2"?>
Java Pour créer un nouveau document XML vide, ce paramètre doit correspondre à une chaîne vide ("").
<Option> : Constante optionnelle
Type du document XML créé (par défaut, aucune option n'est sélectionnée) :
xdHTMLDocument de type XHTML. Cette constante permet d'optimiser le fonctionnement de la fonction XMLConstruitChaîne. Le document est directement traité en utilisant le mode XHTML.
xHTMLDocument de type HTML.
Attention : Cette constante n'est plus disponible. En effet, le fonctionnement de cette constante n'était pas optimisé : le document était manipulé en utilisant le format XML puis en cas d'échec il était ensuite manipulé en utilisant le format XHTML.
Java Ce paramètre n'est pas pris en compte.
Remarques

Rappel : Langage XML

XML est un langage comportant des balises et des attributs (appelés "éléments" dans cette aide). La structure d'un code XML correspond à une arborescence : les informations sont ordonnées selon une hiérarchie.
Voici le vocabulaire utilisé pour décrire les différentes parties d'un code XML :

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.

Limite

La fonction XMLDocument est adaptée au chargement de documents XML dont la taille des noeuds texte n'excède pas 9 Mo. Pour manipuler des documents dont la taille des noeuds est supérieure, il faut utiliser le type XMLDocument.
Composante : wd300xml.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 25/05/2022

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