XMLMapping.SetMapping-Methode (Word)
Ermöglicht das Erstellen oder Ändern der XML-Zuordnung für ein Inhaltssteuerelement. Gibt True zurück, wenn Microsoft Word das Inhaltssteuerelement einem benutzerdefinierten XML-Knoten im benutzerdefinierten XML-Datenspeicher des Dokuments zuordnet.
Syntax
Ausdruck. SetMapping( _XPath_ , _PrefixMapping_ , _Source_ )
Ausdruck Ein Ausdruck, der ein XMLMapping-Objekt zurückgibt.
Parameter
| Name | Erforderlich/Optional | Datentyp | Beschreibung |
|---|---|---|---|
| XPath | Erforderlich | String | Gibt eine XPath-Zeichenfolge an, die den XML-Knoten darstellt, dem das Inhaltssteuerelement zugeordnet werden soll. Bei einer ungültigen XPath-Zeichenfolge tritt ein Laufzeitfehler auf. |
| PrefixMapping | Optional | String | Gibt die Präfixzuordnungen an, die bei Abfragen des im Parameter XPath angegebenen Ausdrucks zu verwenden sind. Wenn dieser Parameter ausgelassen wird, wird von Word die Gruppe von Präfixzuordnungen für die angegebene benutzerdefinierte XML-Komponente im aktuellen Dokument verwendet. |
| Source | Optional | CustomXMLPart | Gibt die gewünschten benutzerdefinierten XML-Daten an, denen das Inhaltssteuerelement zugeordnet werden soll. Wenn dieser Parameter nicht angegeben wird, wird der XPath für alle benutzerdefinierten XML-Dateien im aktuellen Dokument ausgewertet, und die Zuordnung wird mit dem ersten CustomXMLPart eingerichtet, in dem der XPath in einen XML-Knoten aufgelöst wird. |
Rückgabewert
Boolesch
Bemerkungen
Wenn die XML-Zuordnung bereits vorhanden ist, ersetzt Word die vorhandene XML-Zuordnung, und der Inhalt des neuen zugeordneten XML-Knotens ersetzt den Text des Inhaltssteuerelements. Wenn der angegebene XPath nicht zu einem XML-Knoten in den angegebenen benutzerdefinierten XML-Teilen ausgewertet wird, können Sie trotzdem die Zuordnung angeben, und eine wird erstellt. Diese Zuordnung wird automatisch verknüpft, wenn der angegebene XPath zu einem XML-Knoten in den angegebenen benutzerdefinierten XML-Teilen ausgewertet wird.
Siehe auch die SetMappingByNode-Methode .
Hinweis
Beim Erstellen einer Zuordnung für ein Rich-Text-Inhaltssteuerelement tritt ein Laufzeitfehler auf.
Beispiel
Im folgenden Beispiel wird eine benutzerdefinierte XML-Komponente eingefügt und der XML-Code auf die benutzerdefinierte Komponente festgelegt. Dann werden am Anfang des Dokuments zwei Inhaltssteuerelemente eingefügt und der Inhalt der Steuerelemente dem Inhalt der XML-Elemente in der benutzerdefinierten Komponente zugeordnet.
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
Siehe auch
Support und Feedback
Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.