XMLMapping.SetMapping(String, String, CustomXMLPart) Метод

Ссылка

Определение

Пространство имен:: Microsoft.Office.Interop.Word

Сборка:: Microsoft.Office.Interop.Word.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Позволяет создавать или изменять сопоставление XML в элементе управления содержимым. Возвращает значение True, если Microsoft Office Word сопоставляет элемент управления содержимым с пользовательским XML-узлом в пользовательском хранилище XML-данных документа.

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

Параметры

XPath: String

Указывает строку XPath, представляющую XML-узел, с которым сопоставляется элемент управления содержимым. Недопустимая строка XPath вызывает ошибку во время выполнения.

PrefixMapping: String

Указывает сопоставления префиксов, которые будут использоваться при запросе выражения, предоставленного в параметре XPath . Если этот параметр опущен, Word использует набор сопоставлений префиксов для указанной пользовательской XML-части в текущем документе.

Source: CustomXMLPart

Указывает требуемые пользовательские XML-данные, с которыми сопоставляется элемент управления содержимым. Если этот параметр опущен, XPath вычисляется по всем пользовательским XML-файлам в текущем документе, а сопоставление устанавливается с первым элементом CustomXMLPart , в котором XPath разрешается в XML-узел.

Возвращаемое значение

Boolean

Примеры

В следующем примере вставляется настраиваемая XML-часть и устанавливается XML-код для настраиваемой части, а затем вставляется два элемента управления содержимым в начале документа и сопоставляется содержимое элементов УПРАВЛЕНИЯ с содержимым XML-элементов в настраиваемой части.

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

Если сопоставление XML уже существует, Word заменяет существующее сопоставление XML, а содержимое нового сопоставленного XML-узла заменяет текст элемента управления содержимым. Если указанный XPath не вычисляется на XML-узел в указанной пользовательской части ИЛИ частях XML, вы по-прежнему можете указать сопоставление, и оно будет создано. Это сопоставление автоматически связывается, когда указанный XPath будет вычисляться с узлом XML в указанных настраиваемых XML-частях.

См. также SetMappingByNode(CustomXMLNode) метод .

Примечание. Создание сопоставления для элемента управления с содержимым в формате форматированного текста приводит к ошибке во время выполнения.

Применяется к

Поделиться через