Método XMLMapping.SetMapping (Word)
Permite crear o cambiar la asignación XML en un control de contenido. Devuelve True si Microsoft Word asigna el control de contenido a un nodo XML personalizado en el almacén de datos XML personalizado del documento.
Sintaxis
expresión. SetMapping( _XPath_ , _PrefixMapping_ , _Source_ )
Expresión Expresión que devuelve un objeto "XMLMapping".
Parameters
| Nombre | Obligatorio/opcional | Tipo de datos | Descripción |
|---|---|---|---|
| XPath | Obligatorio | 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 | Opcional | String | Especifica las asignaciones de prefijo que se van a usar al consultar la expresión proporcionada en el parámetro XPath. Si se omite, Word utilizará el conjunto de asignaciones de prefijo del fragmento XML personalizado especificado del documento actual. |
| Source | Opcional | 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. |
Valor devuelto
Booleano
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 método SetMappingByNode.
Nota:
Si se crea una asignación para un control de contenido de texto enriquecido, se producirá un error en tiempo de ejecución.
Ejemplo:
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.
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
Consulte también
Soporte técnico y comentarios
¿Tiene preguntas o comentarios sobre VBA para Office o esta documentación? Vea Soporte técnico y comentarios sobre VBA para Office para obtener ayuda sobre las formas en las que puede recibir soporte técnico y enviar comentarios.