DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions de gestion des fichiers XML
  • Gestion de l'ajout
  • Enregistrer les modifications dans le fichier XML
  • 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
XMLAjouteFils (Fonction)
En anglais : XMLAddChild
Ajoute une balise fille dans un document XML. Cette balise fille est ajoutée à la fin de la liste des attributs de la position courante.
Exemple
// Ajout d'une nouvelle ligne de commande
XMLParent("CdeXML")
XMLAjouteFils("CdeXML", "lignecommande", "", Vrai)
XMLAjouteAttribut("CdeXML", "numero", "2")
 
// Ajout de la balise "codeproduit"
XMLAjouteFils("CdeXML", "codeproduit", "sro2125")
 
// Ajout de la balise "designation"
XMLAjouteFils("CdeXML", "designation", "souris optique")
 
// Ajout de la balise "quantité"
XMLAjouteFils("CdeXML", "quantité", "15")
Syntaxe
XMLAjouteFils(<Document XML> , <Balise> [, <Valeur de la balise> [, <Changement de position> [, <Option>]]])
<Document XML> : Chaîne de caractères
Nom du document XML dans lequel l'ajout doit être effectué. Ce document contient le code XML et a été créé avec la fonction XMLDocument.
<Balise> : Chaîne de caractères
Nom de la balise à ajouter.
Si ce paramètre correspond à la constante CDATA, le contenu de la balise CDATA ne sera pas interprété par le parseur XML. Il est par exemple possible de mettre une image au format binaire dans cette balise. Attention : l'encodage utilisé doit respecter l'encodage du document XML.
AndroidWidget Android Attention : Il n'est pas possible de créer des éléments (balise ou attribut) avec des caractères accentués.
<Valeur de la balise> : Chaîne de caractères optionnelle
Valeur de la nouvelle balise. Par défaut, ce paramètre correspond à une chaîne vide.
<Changement de position> : Booléen optionnel
  • Vrai pour se positionner sur l'élément ajouté. Dans ce cas, l'élément ajouté devient la position courante.
  • Faux (valeur par défaut) pour ne pas modifier la position courante lors de l'ajout.
<Option> : Constante optionnelle de type Entier
Options d'ajout. Les valeurs possibles sont :
XMLEncodeEtCommercialSi le caractère "&" ("et" commercial) est présent dans la valeur de la balise ajoutée, il sera encodé sous la forme "&amp;".
Si cette constante n'est pas spécifiée, il est nécessaire d'encoder le caractère "&" dans la balise XML. Aucun encodage ne sera effectué.
Remarques

Gestion de l'ajout

  • Si la position courante est un attribut, la nouvelle balise est ajoutée à la fin de la liste courante des balises filles de la balise qui contient l'attribut.
  • La position courante dans le document ne change pas pendant l'appel à la fonction XMLAjouteFils sauf si le paramètre <Changement de position> est à Vrai.
Remarque : La fonction XMLDocument ne crée pas de racine pour le document. Pour créer un premier fils dans un document vide, il est obligatoire que ce document contienne une racine.

Enregistrer les modifications dans le fichier XML

Pour enregistrer les modifications effectuées dans un fichier XML, vous devez :
  1. Utiliser la fonction XMLConstruitChaîne. Cette fonction récupère et met en forme le contenu d'un document XML.
  2. Enregistrer la chaîne de caractères générée par la fonction XMLConstruitChaîne dans un fichier XML. Pour cela, il suffit d'utiliser la fonction fSauveTexte.
Exemple :
// Après modification du document XML
SourceXML = XMLConstruitChaîne("DocXML")
// Enregistrement du fichier XML
fSauveTexte("ExampleModifié.xml", SourceXML)
WEBDEV - Code Navigateur Cette fonctionnalité n'est pas disponible.

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 : wd290xml.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Ajout avec CDATA
Attention !
Dans l'utilisation de l'attribut CDATA, la variable doit être de type buffer.
ça n'est pas uniquement en Windows Mobile...
lipphi
01 mar. 2017

Dernière modification : 01/09/2022

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