Bind SDT till anpassad XML-del
Den här handledningen visar hur man binder en SDT (Structured Document Tag) till en anpassad XML-del med Aspose.Words för .NET. Med SDT:er kan du lägga till strukturerade innehållskontroller i ett Word-dokument, och CustomXmlParts tillhandahåller ett sätt att lagra anpassade XML-data som är associerade med dokumentet.
Förutsättningar
För att följa denna handledning måste du ha följande:
- Aspose.Words för .NET-biblioteket installerat.
- Grundläggande kunskaper i C# och XML.
Steg 1: Konfigurera dokumentkatalogen
Börja med att ställa in sökvägen till din dokumentkatalog. Byta ut"YOUR DOCUMENT DIRECTORY"
med den faktiska sökvägen till katalogen där du vill spara dokumentet.
string dataDir = "YOUR DOCUMENT DIRECTORY";
Steg 2: Skapa ett dokument och CustomXmlPart
Skapa en ny instans avDocument
klass och aCustomXmlPart
för att lagra anpassade XML-data. Den anpassade XML-filen ska vara i ett giltigt XML-format. I det här exemplet använder vi en enkel XML-sträng<root><text>Hello, World!</text></root>
.
Document doc = new Document();
CustomXmlPart xmlPart = doc.CustomXmlParts.Add(Guid.NewGuid().ToString("B"), "<root><text>Hello, World!</text></root>");
Steg 3: Lägg till en StructuredDocumentTag (SDT) till dokumentet
Lägg till enStructuredDocumentTag
till dokumentet för att fungera som innehållskontroll. SpecificeraSdtType
somPlainText
och denMarkupLevel
somBlock
för att skapa en SDT på blocknivå.
StructuredDocumentTag sdt = new StructuredDocumentTag(doc, SdtType.PlainText, MarkupLevel.Block);
doc.FirstSection.Body.AppendChild(sdt);
Steg 4: Ställ in XML-mappningen för SDT
Kartlägg SDT tillCustomXmlPart
genom att användaSetMapping
metod förXmlMapping
fast egendom. SpecificeraCustomXmlPart
, XPath-uttrycket för att lokalisera den önskade XML-noden och namnområdesprefixet om det behövs. I det här exemplet mappar vi SDT till/root[1]/text[1]
.
sdt.XmlMapping.SetMapping(xmlPart, "/root[1]/text[1]", "");
Steg 5: Spara dokumentet
Spara det ändrade dokumentet i den angivna katalogen med hjälp avSave
metod. Ange önskat filnamn med lämplig filtillägg. I det här exemplet sparar vi dokumentet som “WorkingWithSdt.BindSDTtoCustomXmlPart.doc”.
doc.Save(dataDir + "WorkingWithSdt.BindSDTtoCustomXmlPart.doc");
Exempel på källkod för Bind Sd Tto Custom Xml Part med Aspose.Words för .NET
// Sökväg till din dokumentkatalog
string dataDir = "YOUR DOCUMENT DIRECTORY";
Document doc = new Document();
CustomXmlPart xmlPart =
doc.CustomXmlParts.Add(Guid.NewGuid().ToString("B"), "<root><text>Hello, World!</text></root>");
StructuredDocumentTag sdt = new StructuredDocumentTag(doc, SdtType.PlainText, MarkupLevel.Block);
doc.FirstSection.Body.AppendChild(sdt);
sdt.XmlMapping.SetMapping(xmlPart, "/root[1]/text[1]", "");
doc.Save(dataDir + "WorkingWithSdt.BindSDTtoCustomXmlPart.doc");
Det är allt! Du har framgångsrikt bundit en SDT till en CustomXmlPart i ditt Word-dokument med Aspose.Words för .NET.