DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions de gestion des fichiers XML
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
Sauvegarde un document XML dans un fichier.
Si une description XSD a été utilisée, celle-ci est automatiquement utilisée pour valider le document XML lors de sa sauvegarde.
Exemple
MonDocumentXML est un xmlDocument
...
Filtre est une chaîne = "Fichiers XML (*.xml)" + TAB + "*.xml" + RC + ...
"Tous fichiers (*.*)" + TAB + "*.*"
FichierSortie est une chaîne = fSélecteur("", "", "Sélectionnez un fichier XML ...", ...
Filtre, "xml", fselCrée)
SI FichierSortie <>"" ALORS
XMLSauve(MonDocumentXML, FichierSortie, XMLDocumentDéfaut)
SI ErreurDétectée = Vrai ALORS
ErreurConstruit("Une erreur s'est produite pendant la sauvegarde : %1", ...
ErreurInfo(errComplet))
FIN
FIN
// La description du fichier XML nommé "flux" a été importée dans le projet.
// Un ficher XML vierge va être créé à partir de cette description.
// Le ficher XML n'existe pas encore physiquement.
// Chargement du contenu XML
MonDocXML est un xmlDocument,description="flux"
MonDocXML.rss.Channel[1].Title = gsParamTitre
MonDocXML.rss.Channel[1].Link = gsParamAdresseSite
MonDocXML.rss.Channel[1].Description = gsParamDescriptionSite
MonDocXML.rss.Channel[1].Copyright = gsParamCopyright
MonDocXML.rss.Channel[1].Webmaster = gsParamAdesseContact
MonDocXML.rss.Channel[1].Image = gsParamURLImageSite
MonDocXML.rss.Channel[1].Generator = "Easy RSS"
// Sauvegarde du fichier
XMLSauve(MonDocXML, gsCheminFichierXML)
// Sauvegarde du fichier avec mise en forme (nouveauté 22)
XMLSauve(MonDocXML, gsCheminFichierXML_Avec_MiseEnForme, XMLMiseEnForme)
Syntaxe
XMLSauve(<Document XML> [, <Nom et chemin du fichier>] [, <Options>])
<Document XML> : Variable de type xmlDocument
Variable de type xmlDocument contenant le document à sauvegarder. Cette variable peut être le résultat d'un appel à la fonction XMLOuvre ou avoir été déclarée et initialisée directement.
<Nom et chemin du fichier> : Chaîne de caractères ANSI ou Unicode optionnelle
Nom et chemin complet (ou relatif) du fichier texte à créer. Il est possible d'utiliser un chemin UNC.
Si ce paramètre n'est pas spécifié ou vaut "" (chaîne vide) :
  • Lors du premier appel à XMLSauve sur ce document, le document XML est sauvegardé à l'emplacement spécifié lors de son ouverture (fonction XMLOuvre).
  • Lors des appels suivants à XMLSauve, le document XML est sauvegardé à l'emplacement spécifié lors de la précédente sauvegarde.
  • Si le document XML n'a pas été ouvert par la fonction XMLOuvre (ouvert depuis une URL, une chaîne ou si le document a été créé), une erreur est affichée.
<Options> : Constante optionnelle de type Entier
Options de sauvegarde du document XML.
Les valeurs possibles sont :
XMLDocumentDéfaut
(valeur par défaut)
Sauvegarde le document XML avec un entête.
XMLMiseEnFormeSauvegarde le document XML avec une mise en forme (indentation et retours chariot).
AndroidWidget Android Cette constante est désormais disponible.
Java Cette constante n'est pas disponible.
XMLSansEntêteSauvegarde le document XML sans entête. Cette constante peut être utilisée par exemple lorsque le document XML manipulé correspond à un fragment d'un document plus important, concaténé avec d'autres documents XML par la suite.
xvSansValidationSauvegarde le document XML sans prendre en compte le modèle XSD précisé lors de la description du document XML.
AndroidWidget AndroidJava Cette constante n'est pas disponible.
Remarques
Lors de la description d'un document XML, il est possible de spécifier le fichier XSD qui servira de modèle de validation au fichier XML. Par exemple :
cMonDoc est un xmlDocument <description="personne.xsd">
Par défaut, ce fichier XSD est pris en compte lors de la sauvegarde du document : la validité du document est automatiquement vérifiée avant de sauvegarder le document XML (équivalent à la fonction XMLDocumentValide). Pour ne pas effectuer cette validation, il suffit d'utiliser la constante xvSansValidation.
Classification Métier / UI : Code métier
Composante : wd300xml.dll
Version minimum requise
  • Version 15
Documentation également disponible pour…
Commentaires
En windev 18 : le fichier du schéma XSD doit être dans le répertoire du projet
Le fichier contenant le schéma XSD doit être absolument dans le répertoire du projet.
Sans la présence de ce fichier dans le répertoire du projet le xmlsauve n'effectuera pas le contrôle de validité par rapport au xsd (du coup l'instruction xmlns ne sera pas ajoutée automatiquement dans votre fichier xml et le format des dates ne seront pas contrôlé
Gilles FROMONT
07 jan. 2014

Dernière modification : 25/05/2022

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