|
|
|
|
|
|
|
|
|
|
- Cas particuliers
- Assistant de code
XMLLit (Fonction) En anglais : XMLRead Renvoie la valeur d'un élément XML ou la valeur de l'attribut d'un élément XML.
MonDoc est une chaîne = fChargeTexte("exemple.xml")
XMLDocument("DOM", MonDoc)
sNomFonction est une chaîne = XMLLit("DOM","/Exemple/Aide/Fonction")
sTypeFonction est une chaîne = XMLLit("DOM","Aide/Fonction/@type")
sNomFonction2 est une chaîne = XMLLit("DOM","Aide/Fonction[2]")
sImage est une chaîne = XMLLit("DOM","Aide[2]/@image")
sTypeImage est une chaîne = XMLLit("DOM","/Exemple/Aide[@image=""trait.jpg""]/@format", "NonDefini")
XMLTermine("DOM")
// S'applique au document XML suivant:
// <Exemple>
// <Aide>
// <Fonction type="1">Lire</Fonction>
// <Fonction>Ecrire</Fonction>
// </Aide>
// <Aide image="trait.jpg" format="jpg" />
// </Exemple>
Syntaxe
<Résultat> = XMLLit(<Document XML> , <Chemin de l'élément à  lire> [, <Non trouvé>])
<Résultat> : Chaîne de caractères - Valeur de l'élément ou de l'attribut,
- Chaîne vide ("") ou la valeur du paramètre <Non trouvé> dans les cas suivants :
- si l'élément n'a pas été trouvé.
- si l'élément n'a pas de valeur
- si la requête XPath n'est pas une requête de sélection d'enregistrements.
Dans ce cas, la variable ErreurDétectée est à Vrai et la fonction ErreurInfo permet d'obtenir plus de détails sur l'erreur.
<Document XML> : Chaîne de caractères Nom du document XML dans lequel la lecture doit être effectuée. Ce document contient le code XML à analyser et a été créé avec la fonction XMLDocument. <Chemin de l'élément à lire> : Chaîne de caractères Peut correspondre :- au chemin dans le XML de la valeur à lire. Attention : la casse utilisée est prise en compte (minuscules et majuscules). Pour lire la valeur d'un attribut, il suffit de faire précéder le nom de l'attribut par le caractère "@".
- au texte d'une requête XPath à exécuter. La requête XPath doit être de type "sélection d'enregistrements". Si plusieurs éléments répondent à la sélection, le premier trouvé est utilisé.
Si ce chemin ne commence pas par "/", le nom du noeud racine est automatiquement ajouté. Si le document XML n'a pas de racine, <Résultat> correspond à <Non trouvé>. <Non trouvé> : Chaîne de caractères optionnelle Texte à renvoyer si l'élément n'a pas été trouvé. Par défaut, ce paramètre correspond à une chaîne vide (""). Remarques Cas particuliers - La fonction XMLLit ne modifie pas la position courante dans le document.
- Il n'est pas possible d'imbriquer plusieurs requêtes XML de parcours.
- La fonction XMLLit ne doit pas être utilisée avec une variable de type XMLDocument. Pour lire le contenu d'une variable de type XMLDocument, utilisez la syntaxe "POUR TOUT".
Classification Métier / UI : Code métier Composante : wd300xml.dll
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|