XmlMapping.SetMapping, méthode (Word)
Permet de créer ou modifier le mappage XML sur un contrôle de contenu. Renvoie la valeur True si Microsoft Word mappe le contrôle de contenu à un nœud XML personnalisé dans le magasin de données XML personnalisé du document.
Syntaxe
expression. SetMapping( _XPath_ , _PrefixMapping_ , _Source_ )
Expression Expression qui renvoie un objet « XMLMapping ».
Parameters
| Nom | Requis/Facultatif | Type de données | Description |
|---|---|---|---|
| XPath | Obligatoire | Chaîne | Spécifie une chaîne XPath qui représente le nœud XML sur lequel mapper le contrôle de contenu. Une chaîne XPath non valide génère une erreur d'exécution. |
| PrefixMapping | Facultatif | Chaîne | Spécifie des mappages de préfixes à utiliser lors de la demande de l'expression fournie dans le paramètre XPath. En cas d'omission, Word utilise le jeu de mappages de préfixes pour la partie XML personnalisée spécifiée du document actif. |
| Source | Facultatif | CustomXMLPart | Spécifie les données XML personnalisées souhaitées sur lequel mapper le contrôle de contenu. Si ce paramètre est omis, XPath est évalué par rapport à toutes les données XML personnalisées dans le document actif, et la mise en correspondance est établie avec le premier CustomXMLPart dans lequel XPath est résolu sur un nœud XML. |
Valeur renvoyée
Booléen
Remarques
Si le mappage XML existe déjà, Word remplace le mappage XML existant et le contenu du nouveau nœud XML mappé remplace le texte du contrôle de contenu. Si le XPath spécifié n'évalue pas un nœud XML dans la ou les parties XML personnalisées spécifiées, vous pouvez toujours spécifier le mappage pour en créer un. Ce mappage est automatiquement lié lorsque le XPath spécifié est évalué sur un nœud XML dans la ou les parties XML personnalisées spécifiées.
Voir aussi la méthode SetMappingByNode.
Remarque
La création d'un mappage pour un contrôle de contenu de texte enrichi génère une erreur d'exécution.
Exemple
Cet exemple montre comment insérer une partie XML personnalisée, définir les données XML pour la partie personnalisée, insérer deux contrôles de contenu au début du document et mapper le contenu des contrôles sur le contenu des éléments XML dans la partie personnalisée.
Dim objRange As Range
Dim objCustomPart As CustomXMLPart
Dim objCustomControl As ContentControl
Set objCustomPart = ActiveDocument.CustomXMLParts.Add
objCustomPart.LoadXML ("<books><book><author>Matt Hink</author>" & _
"<title>Migration Paths of the Red Breasted Robin</title>" & _
"<genre>non-fiction</genre><price>29.95</price>" & _
"<pub_date>2/1/2007</pub_date><abstract>You see them in " & _
"the spring outside your windows. You hear their lovely " & _
"songs wafting in the warm spring air. Now follow the path " & _
"of the red breasted robin as it migrates to warmer climes " & _
"in the fall, and then back to your back yard in the spring." & _
"</abstract></book></books>")
ActiveDocument.Range.InsertParagraphBefore
Set objRange = ActiveDocument.Paragraphs(1).Range
Set objCustomControl = ActiveDocument.ContentControls _
.Add(wdContentControlText, objRange)
objCustomControl.XMLMapping.SetMapping _
"/books/book/title", , objCustomPart
objRange.InsertParagraphAfter
Set objRange = ActiveDocument.Paragraphs(2).Range
Set objCustomControl = ActiveDocument.ContentControls _
.Add(wdContentControlText, objRange)
objCustomControl.XMLMapping.SetMapping _
"/books/book/abstract", , objCustomPart
Voir aussi
Assistance et commentaires
Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.