XmlMapping

XmlMapping class

Spécifie les informations utilisées pour établir un mappage entre la balise de document structuré parent et un élément XML stocké dans une partie de données XML personnalisée dans le document.

Pour en savoir plus, visitez leBalises de documents structurés ou contrôle de contenu article documentaire.

public class XmlMapping

Propriétés

NomLa description
CustomXmlPart { get; }Renvoie la partie de données XML personnalisée à laquelle la balise du document structuré parent est mappée.
IsMapped { get; }Retoursvrai si la balise du document structuré parent est mappée avec succès aux données XML.
PrefixMappings { get; }Renvoie les mappages de préfixes d’espace de noms XML pour évaluer leXPath .
StoreItemId { get; }Spécifie l’identifiant de données XML personnalisé pour la partie de données XML personnalisée which doit être utilisé pour évaluer leXPath expression.
XPath { get; }Renvoie l’expression XPath, qui est évaluée pour trouver le nœud XML personnalisé mappé à la balise du document structuré parent.

Méthodes

NomLa description
Delete()Supprime le mappage du document structuré parent avec les données XML.
SetMapping(CustomXmlPart, string, string)Définit un mappage entre la balise de document structuré parent et un nœud XML d’une partie de données XML personnalisée.

Exemples

Montre comment définir des mappages XML pour les parties XML personnalisées.

Document doc = new Document();

// Construisez une partie XML contenant du texte et ajoutez-la à la collection CustomXmlPart du document.
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));

// Créez une balise de document structuré qui affichera le contenu de notre CustomXmlPart.
StructuredDocumentTag tag = new StructuredDocumentTag(doc, SdtType.PlainText, MarkupLevel.Block);

// Définissez un mappage pour notre balise de document structuré. Cette cartographie indiquera
// notre balise de document structuré pour afficher une partie du contenu textuel de la partie XML vers laquelle pointe XPath.
// Dans ce cas, ce sera le contenu du deuxième "<text>" élément du premier "<root>" élément : "Élément de texte #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);

// Ajoutez la balise de document structuré au document pour afficher le contenu de notre partie personnalisée.
doc.FirstSection.Body.AppendChild(tag);
doc.Save(ArtifactsDir + "StructuredDocumentTag.XmlMapping.docx");

Voir également