Partager via


XMLMapping.SetMapping(String, String, CustomXMLPart) Méthode

Définition

Permet de créer ou modifier le mappage XML sur un contrôle de contenu. Renvoie la valeur True si Microsoft Office Word mappe le contrôle de contenu à un nœud XML personnalisé dans le magasin de données XML personnalisé du document.

public bool SetMapping (string XPath, string PrefixMapping = "", Microsoft.Office.Core.CustomXMLPart Source = default);
abstract member SetMapping : string * string * Microsoft.Office.Core.CustomXMLPart -> bool
Public Function SetMapping (XPath As String, Optional PrefixMapping As String = "", Optional Source As CustomXMLPart = null) As Boolean

Paramètres

XPath
String

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
String

Spécifie les mappages de préfixe à utiliser lors de l’interrogation de l’expression fournie dans le XPath paramètre . 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
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.

Retours

Boolean

Exemples

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.

<span class="label">Dim objRange As Range































































































































Dim objCustomPart As CustomXMLPart































































































































Dim objCustomControl As ContentControl































































































































































































































































Set objCustomPart = ActiveDocument.CustomXMLParts.Add































































































































objCustomPart.LoadXML ("&lt;books&gt;&lt;book&gt;&lt;author&gt;Matt Hink&lt;/author&gt;" &amp; _































































































































    "&lt;title&gt;Migration Paths of the Red Breasted Robin&lt;/title&gt;" &amp; _































































































































    "&lt;genre&gt;non-fiction&lt;/genre&gt;&lt;price&gt;29.95&lt;/price&gt;" &amp; _































































































































    "&lt;pub_date&gt;2/1/2007&lt;/pub_date&gt;&lt;abstract&gt;You see them in " &amp; _































































































































    "the spring outside your windows.  You hear their lovely " &amp; _































































































































    "songs wafting in the warm spring air.  Now follow the path " &amp; _































































































































    "of the red breasted robin as it migrates to warmer climes " &amp; _































































































































    "in the fall, and then back to your back yard in the spring." &amp; _































































































































    "&lt;/abstract&gt;&lt;/book&gt;&lt;/books&gt;")































































































































































































































































ActiveDocument.Range.InsertParagraphBefore































































































































Set objRange = ActiveDocument.Paragraphs(1).Range































































































































Set objCustomControl = ActiveDocument.ContentControls _































































































































    .Add(wdContentControlText, objRange)































































































































objCustomControl.XMLMapping.</span>
<span class="label">SetMapping</span>
<span class="label">_    "/books/book/title", , objCustomPartobjRange.InsertParagraphAfterSet objRange = ActiveDocument.Paragraphs(2).RangeSet objCustomControl = ActiveDocument.ContentControls _    .Add(wdContentControlText, objRange)objCustomControl.XMLMapping.</span>
<span class="label">SetMapping</span>
<span class="label">_    "/books/book/abstract", , objCustomPart</span>

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 SetMappingByNode(CustomXMLNode) méthode .

Remarque : La création d’un mappage pour un contrôle de contenu de texte enrichi provoque une erreur d’exécution.

S’applique à