XmlMapping

XmlMapping class

Gibt die Informationen an, die verwendet werden, um eine Zuordnung zwischen dem strukturierten Dokument-Tag parent und einem XML-Element herzustellen, das in einem benutzerdefinierten XML-Datenteil im Dokument gespeichert ist.

public class XmlMapping

Eigenschaften

Name Beschreibung
CustomXmlPart { get; } Gibt den benutzerdefinierten XML-Datenteil zurück, dem das übergeordnete strukturierte Dokument-Tag zugeordnet ist.
IsMapped { get; } gibt zurück Stimmt wenn das übergeordnete strukturierte Dokument-Tag erfolgreich XML-Daten zugeordnet wurde.
PrefixMappings { get; } Gibt XML-Namespace-Präfixzuordnungen zurück, um die auszuwertenXPath .
StoreItemId { get; } Gibt den benutzerdefinierten XML-Datenbezeichner für den benutzerdefinierten XML-Datenteil an, der zur Auswertung verwendet werden sollXPath Ausdruck.
XPath { get; } Gibt den XPath-Ausdruck zurück, der ausgewertet wird, um den benutzerdefinierten XML-Knoten zu finden, der dem übergeordneten Tag des strukturierten Dokuments zugeordnet ist.

Methoden

Name Beschreibung
Delete() Löscht die Zuordnung des übergeordneten strukturierten Dokuments zu XML-Daten.
SetMapping(CustomXmlPart, string, string) Legt eine Zuordnung zwischen dem übergeordneten Tag des strukturierten Dokuments und einem XML-Knoten eines benutzerdefinierten XML-Datenteils fest.

Beispiele

Zeigt, wie XML-Zuordnungen für benutzerdefinierte XML-Teile festgelegt werden.

Document doc = new Document();

// Erstellen Sie einen XML-Teil, der Text enthält, und fügen Sie ihn der CustomXmlPart-Sammlung des Dokuments hinzu.
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));

// Erstellen Sie ein strukturiertes Dokument-Tag, das den Inhalt unseres CustomXmlPart anzeigt.
StructuredDocumentTag tag = new StructuredDocumentTag(doc, SdtType.PlainText, MarkupLevel.Block);

// Legen Sie eine Zuordnung für unser strukturiertes Dokument-Tag fest. Diese Zuordnung wird anweisen
// unser strukturiertes Dokument-Tag, um einen Teil des Textinhalts des XML-Teils anzuzeigen, auf den der XPath zeigt.
// In diesem Fall ist es der Inhalt des zweiten "<text>" Element des ersten "<root>" element: "Textelement #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);

// Fügen Sie dem Dokument das strukturierte Dokument-Tag hinzu, um den Inhalt unseres benutzerdefinierten Teils anzuzeigen.
doc.FirstSection.Body.AppendChild(tag);
doc.Save(ArtifactsDir + "StructuredDocumentTag.XmlMapping.docx");

Siehe auch