DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions de gestion des fichiers 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
XMLRetourPosition (Fonction)
En anglais : XMLRestorePosition
Restaure le contexte précédemment sauvegardé d'un document XML (fonction XMLSauvePosition). Le filtre en cours lors de la sauvegarde de la position peut être restauré (le filtre est mis en place avec la fonction XMLRecherche).
SI XMLDocument("MonDocXML", CodeXML) = Vrai ALORS
	// Recherche des liens
	XMLRecherche("MonDocXML", "a", XMLBalise)
	TANTQUE XMLTrouve("MonDocXML") = Vrai
		SI XMLFilsExiste("MonDocXML", XMLAttribut) = Vrai ALORS
			LaPositionXML est un entier = XMLSauvePosition("MonDocXML")
			XMLFils("MonDocxml")
			Trace(XMLDonnée("MonDocXML")) 
			// Traitement
			XMLRetourPosition("MonDocXML", LaPositionXML, XMLRPFiltre) 
		FIN
		// Elément suivant dans la recherche
		XMLSuivant("MonDocXML")
	 FIN
FIN
Syntaxe
<Résultat> = XMLRetourPosition(<Document XML> , <Position> [, <Options>])
<Résultat> : Entier
  • Vrai si la restauration de la position est effectuée,
  • Faux dans le cas contraire (la variable ErreurDétectée est alors à Vrai). Pour obtenir plus de détails sur l'erreur, utilisez la fonction ErreurInfo.
<Document XML> : Chaîne de caractères
Nom du document XML manipulé. Ce document contient le code XML à analyser et a été créé avec la fonction XMLDocument.
<Position> : Entier
Position à restaurer. Cette position a été renvoyée par la fonction XMLSauvePosition.
<Options> : Constante ou combinaison de constantes optionnelles
Permet de paramétrer la restauration :
XMLRPConserveLa position n'est pas libérée (d'autres appels à la fonction XMLRetourPosition pourront être réalisés sur cette position).
XMLRPDéfaut
(valeur par défaut)
La position est libérée. La position sauvegardée est restaurée.
XMLRPFiltreRestaure le filtre posé au moment du XMLSauvePosition.
Remarques

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.
Classification Métier / UI : Code métier
Composante : wd300xml.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Retour position suite à XMLSupprime()
On peut faire un retour position sur un noeud qui a supprimé avec XMLSupprime.
XMLRetourPosition() renvoie d'ailleurs Vrai, comme si tout s'était bien passé.
La valeur de retour de XMLTrouve() est identique à celle avant XMLSupprime().
Au moins, si on fait un XMLSuivant(), ça nous renvoie Faux.
VincentRG
09 juil. 2020
Retour de XMLTrouve() et XMLEnDehors()
Attention, la valeur de retour de XMLTrouve() et XMLEnDehors() n'est pas affecté par un XMLRetourPosition().
Si le document XML était sur une position invalide, même en faisant un retour position sur une position valide, XMLTrouve() renvoie Faux!!
VincentRG
09 juil. 2020

Dernière modification : 25/05/2022

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