PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

  • 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/iPadApple WatchUniversal Windows 10 AppWindows Mobile
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.
Versions 15 et supérieures
Android Cette fonction est désormais disponible pour les applications Android.
Nouveauté 15
Android Cette fonction est désormais disponible pour les applications Android.
Android Cette fonction est désormais disponible pour les applications Android.
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
Widget Android Cette fonction est désormais disponible en mode Widget Android.
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Nouveauté 18
Widget Android Cette fonction est désormais disponible en mode Widget Android.
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Widget Android Cette fonction est désormais disponible en mode Widget Android.
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.
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êtesWindows MobileUniversal Windows 10 AppJavaPHPAjaxCode 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 avec guillemets
Nom donné au document XML. Ce nom sera utilisé par toutes les fonctions XML.
<Code XML> : Chaîne de caractères (avec guillemets) 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) :
Versions 16 et supérieures
xdHTML
Nouveauté 16
xdHTML
xdHTML
Document 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.
Versions 16 et supérieures
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.
Nouveauté 16
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.
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 : wd240xml.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire