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
WindowsLinuxJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac Catalyst
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.
PHP Pour créer un document XML, le support du parseur XML doit être activé sur le serveur PHP.
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
...
WINDEVWEBDEV - Code ServeurEtats et RequêtesJavaCode Utilisateur (MCU)PHPAjax
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"?>
PHP Ce code doit être au format ANSI.
AndroidWidget AndroidJava 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.
AndroidWidget AndroidJavaPHP 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 : 20/09/2024

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