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

Definición

Espacio de nombres:

Microsoft.Office.Interop.Word

Ensamblado:

Microsoft.Office.Interop.Word.dll

Permite crear o cambiar la asignación XML en un control de contenido. Devuelve True si Microsoft Office Word asigna el control de contenido a un nodo XML personalizado en el almacén de datos XML personalizado del documento.

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

Parámetros

XPath

String

Especifica una cadena XPath que representa el nodo XML al que se asignará el control de contenido. Si la cadena XPath no es válida, se producirá un error en tiempo de ejecución.

PrefixMapping

String

Especifica las asignaciones de prefijos que se usarán al consultar la expresión proporcionada en el XPath parámetro . Si se omite, Word utilizará el conjunto de asignaciones de prefijo del fragmento XML personalizado especificado del documento actual.

Source

CustomXMLPart

Especifica los datos XML personalizados deseados al que se asignará el control de contenido. Si se omite este parámetro, se evalúa la expresión XPath con todo el código XML personalizado en el documento actual, y la asignación se establece con el primer objeto CustomXMLPart en la que XPath se resuelve en un nodo XML.

Devoluciones

Boolean

Booleano

Ejemplos

En el siguiente ejemplo, se inserta un fragmento XML personalizado, se establece el código XML correspondiente y, a continuación, se insertan dos controles de contenido al principio del documento y se asigna el contenido de los controles al contenido de elementos XML del fragmento personalizado.

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

Comentarios

Si ya existe la asignación XML, Word la reemplaza y el contenido del nuevo nodo XML asignado reemplaza el texto del control de contenido. Si el parámetro XPath especificado no se evalúa en un nodo XML de los fragmentos XML personalizados especificados, se puede especificar la asignación para crear uno. Esta asignación se vincula automáticamente cuando el parámetro XPath especificado se evalúe en un nodo XML de los fragmentos XML personalizados especificados.

Vea también el SetMappingByNode(CustomXMLNode) método .

Nota: La creación de una asignación para un control de contenido de texto enriquecido provoca un error en tiempo de ejecución.