Bind SDT aan een aangepast XML-onderdeel

In deze zelfstudie wordt gedemonstreerd hoe u een Structured Document Tag (SDT) koppelt aan een aangepast XML-onderdeel met behulp van Aspose.Words voor .NET. Met SDT’s kunt u gestructureerde inhoudsbesturingselementen toevoegen aan een Word-document, en CustomXmlParts bieden een manier om aangepaste XML-gegevens op te slaan die aan het document zijn gekoppeld.

Vereisten

Om deze tutorial te volgen, heb je het volgende nodig:

• Aspose.Words voor .NET-bibliotheek geïnstalleerd.
• Basiskennis van C# en XML.

Stap 1: Stel de documentmap in

Begin met het instellen van het pad naar uw documentmap. Vervangen"YOUR DOCUMENT DIRECTORY"met het daadwerkelijke pad naar de map waar u het document wilt opslaan.

string dataDir = "YOUR DOCUMENT DIRECTORY";

Stap 2: Maak een document en CustomXmlPart

Maak een nieuw exemplaar van deDocument klasse en eenCustomXmlPart om de aangepaste XML-gegevens op te slaan. De aangepaste XML moet een geldig XML-formaat hebben. In dit voorbeeld gebruiken we een eenvoudige XML-tekenreeks<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>");

Stap 3: Voeg een StructuredDocumentTag (SDT) toe aan het document

Voeg een … toeStructuredDocumentTag naar het document om als inhoudscontrole te dienen. Specificeer deSdtType alsPlainText en deMarkupLevel alsBlock om een SDT op blokniveau te maken.

StructuredDocumentTag sdt = new StructuredDocumentTag(doc, SdtType.PlainText, MarkupLevel.Block);
doc.FirstSection.Body.AppendChild(sdt);

Stap 4: Stel de XML-toewijzing voor de SDT in

Wijs de SDT toe aan deCustomXmlPart door gebruik te maken van deSetMapping werkwijze van deXmlMapping eigendom. Specificeer deCustomXmlPart , de XPath-expressie om het gewenste XML-knooppunt te lokaliseren, en indien nodig het naamruimtevoorvoegsel. In dit voorbeeld wijzen we de SDT toe aan/root[1]/text[1].

sdt.XmlMapping.SetMapping(xmlPart, "/root[1]/text[1]", "");

Stap 5: Sla het document op

Sla het gewijzigde document op in de opgegeven map met behulp van deSave methode. Geef de gewenste bestandsnaam op met de juiste bestandsextensie. In dit voorbeeld slaan we het document op als “WorkingWithSdt.BindSDTtoCustomXmlPart.doc”.

doc.Save(dataDir + "WorkingWithSdt.BindSDTtoCustomXmlPart.doc");

Voorbeeldbroncode voor Bind Sd Tto Custom XML Part met Aspose.Words voor .NET

	// Pad naar uw documentmap
	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");

Dat is het! U hebt met succes een SDT aan een CustomXmlPart in uw Word-document gebonden met behulp van Aspose.Words voor .NET.