Метод XMLMapping.SetMapping (Word)

Статья
04/07/2023

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

Синтаксис

выражение. SetMapping( _XPath_ , _PrefixMapping_ , _Source_ )

Выражение Выражение, возвращающее объект XMLMapping.

Параметры

Имя	Обязательный или необязательный	Тип данных	Описание
XPath	Обязательный	String	Указывает строку XPath, представляющую XML-узел, с которым сопоставляется элемент управления содержимым. Недопустимая строка XPath вызывает ошибку во время выполнения.
PrefixMapping	Необязательный	String	Указывает сопоставления префиксов, которые будут использоваться при запросе выражения, предоставленного в параметре XPath. Если этот параметр опущен, Word использует набор сопоставлений префиксов для указанной пользовательской XML-части в текущем документе.
Source	Optional	CustomXMLPart	Указывает требуемые пользовательские XML-данные, с которыми сопоставляется элемент управления содержимым. Если этот параметр опущен, XPath вычисляется по всем пользовательским XML-файлам в текущем документе, а сопоставление устанавливается с первым элементом CustomXMLPart , в котором XPath разрешается в XML-узел.

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

Boolean

Примечания

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

См. также метод SetMappingByNode .

Примечание.

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

Пример

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

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

См. также

Объект XMLMapping

Поддержка и обратная связь

Есть вопросы или отзывы, касающиеся Office VBA или этой статьи? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.

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