XMLMapping.SetMapping(String, String, CustomXMLPart) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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
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 ("<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.</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.