XMLMapping.SetMapping(String, String, CustomXMLPart) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Permite criar ou alterar o mapeamento XML em um controle de conteúdo. Retorna True se o Microsoft Office Word mapear o controle de conteúdo para um nó XML personalizado no armazenamento de dados XML personalizado do documento.
public bool SetMapping (string XPath, string PrefixMapping = "", Microsoft.Office.Core.CustomXMLPart Source = default);abstract member SetMapping : string * string * Microsoft.Office.Core.CustomXMLPart -> boolPublic Function SetMapping (XPath As String, Optional PrefixMapping As String = "", Optional Source As CustomXMLPart = null) As BooleanParâmetros
- XPath
- String
Especifica uma sequência de caracteres do XPath que representa o nó XML ao qual o controle de conteúdo será mapeado. Uma sequência de caracteres do XPath inválida causa um erro em tempo de execução.
- PrefixMapping
- String
Especifica os mapeamentos de prefixo a serem usados ao consultar a expressão fornecida no XPath parâmetro. Se for omitido, o Word utilizará o conjunto de mapeamentos de prefixo para a parte XML personalizada especificada no documento atual.
- Source
- CustomXMLPart
Especifica os dados XML personalizados desejados para a qual mapear o controle de conteúdo. Se esse parâmetro for omitido, o XPath é avaliado em relação a todos os XML personalizadas no documento atual e o mapeamento é estabelecido com o primeiro CustomXMLPart no qual o XPath resolve para um nó XML.
Retornos
Booliano
Exemplos
O exemplo a seguir insere uma parte XML personalizada, define o XML para a parte personalizada e, em seguida, insere dois controles de conteúdo no início do documento, mapeando o conteúdo dos controles para o conteúdo dos elementos XML na parte personalizada.
<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>
Comentários
Se o mapeamento XML já existir, o Word substituirá o mapeamento XML existente e o conteúdo do novo nó XML mapeado substituirá o texto do controle de conteúdo. Se o XPath especificado não for avaliado para um nó XML nas partes XML personalizadas especificadas, ainda será possível especificar o mapeamento e ele será criado. Esse mapeamento é vinculado automaticamente quando o XPath especificado for avaliado para um nó XML nas partes XML personalizadas especificadas.
Consulte também o SetMappingByNode(CustomXMLNode) método.
Observação: a criação de um mapeamento para um controle de conteúdo de texto avançado causa um erro em tempo de execução.