XMLMapping.SetMapping(String, String, CustomXMLPart) Methode

Referenz

Definition

Namespace:: Microsoft.Office.Interop.Word

Assembly:: Microsoft.Office.Interop.Word.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ermöglicht das Erstellen oder Ändern der XML-Zuordnung für ein Inhaltssteuerelement. Gibt True zurück, wenn Microsoft Office Word das Inhaltssteuerelement einem benutzerdefinierten XML-Knoten im benutzerdefinierten XML-Datenspeicher des Dokuments zuordnet.

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

Parameter

XPath: 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: String

Gibt die Präfixzuordnungen an, die beim Abfragen des im XPath -Parameter bereitgestellten Ausdrucks verwendet werden sollen. 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: 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.

Gibt zurück

Boolean

Boolesch

Beispiele

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.

<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>

Hinweise

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(CustomXMLNode) -Methode.

Hinweis: Das Erstellen einer Zuordnung für ein Rich-Text-Inhaltssteuerelement verursacht einen Laufzeitfehler.

Gilt für:

Freigeben über