XmlMapping

XmlMapping class

Specifica le informazioni utilizzate per stabilire una mappatura tra il tag del documento strutturato parent e un elemento XML memorizzato all’interno di una parte di dati XML personalizzata nel documento.

Per saperne di più, visita ilTag di documenti strutturati o controllo dei contenuti articolo di documentazione.

public class XmlMapping

Proprietà

NomeDescrizione
CustomXmlPart { get; }Restituisce la parte di dati XML personalizzata a cui è mappato il tag del documento strutturato padre.
IsMapped { get; }RestituisceVERO se il tag del documento strutturato padre è mappato correttamente sui dati XML.
PrefixMappings { get; }Restituisce i mapping dei prefissi dello spazio dei nomi XML per valutareXPath .
StoreItemId { get; }Specifica l’identificatore di dati XML personalizzato per la parte di dati XML personalizzata che deve essere utilizzata per valutare ilXPath espressione.
XPath { get; }Restituisce l’espressione XPath, che viene valutata per trovare il nodo XML personalizzato che è mappato al tag del documento strutturato padre.

Metodi

NomeDescrizione
Delete()Elimina la mappatura del documento strutturato padre ai dati XML.
SetMapping(CustomXmlPart, string, string)Imposta una mappatura tra il tag del documento strutturato padre e un nodo XML di una parte di dati XML personalizzata.

Esempi

Mostra come impostare i mapping XML per le parti XML personalizzate.

Document doc = new Document();

// Crea una parte XML che contiene testo e aggiungila alla raccolta CustomXmlPart del documento.
string xmlPartId = Guid.NewGuid().ToString("B");
string xmlPartContent = "<root><text>Text element #1</text><text>Text element #2</text></root>";
CustomXmlPart xmlPart = doc.CustomXmlParts.Add(xmlPartId, xmlPartContent);

Assert.AreEqual("<root><text>Text element #1</text><text>Text element #2</text></root>",
    Encoding.UTF8.GetString(xmlPart.Data));

// Crea un tag di documento strutturato che visualizzerà il contenuto del nostro CustomXmlPart.
StructuredDocumentTag tag = new StructuredDocumentTag(doc, SdtType.PlainText, MarkupLevel.Block);

// Imposta una mappatura per il nostro tag di documento strutturato. Questa mappatura istruirà
// il nostro tag di documento strutturato per visualizzare una porzione del contenuto di testo della parte XML a cui punta XPath.
// In questo caso, sarà il contenuto del secondo elemento "<text>" del primo elemento "<root>": "Elemento testo n. 2".
tag.XmlMapping.SetMapping(xmlPart, "/root[1]/text[2]", "xmlns:ns='http://www.w3.org/2001/XMLSchema'");

Assert.True(tag.XmlMapping.IsMapped);
Assert.AreEqual(xmlPart, tag.XmlMapping.CustomXmlPart);
Assert.AreEqual("/root[1]/text[2]", tag.XmlMapping.XPath);
Assert.AreEqual("xmlns:ns='http://www.w3.org/2001/XMLSchema'", tag.XmlMapping.PrefixMappings);

// Aggiungi il tag del documento strutturato al documento per visualizzare il contenuto della nostra parte personalizzata.
doc.FirstSection.Body.AppendChild(tag);
doc.Save(ArtifactsDir + "StructuredDocumentTag.XmlMapping.docx");

Guarda anche

StructuredDocumentTagRangeStart Class