Vincular SDT à parte XML personalizada
Este tutorial demonstra como vincular uma tag de documento estruturado (SDT) a uma parte Xml personalizada usando Aspose.Words for .NET. Os SDTs permitem adicionar controles de conteúdo estruturados a um documento do Word, e CustomXmlParts fornecem uma maneira de armazenar dados XML personalizados associados ao documento.
Pré-requisitos
Para seguir este tutorial, você precisa ter o seguinte:
- Biblioteca Aspose.Words para .NET instalada.
- Conhecimento básico de C# e XML.
Etapa 1: configurar o diretório de documentos
Comece configurando o caminho para o diretório do seu documento. Substituir"YOUR DOCUMENT DIRECTORY"
com o caminho real para o diretório onde você deseja salvar o documento.
string dataDir = "YOUR DOCUMENT DIRECTORY";
Etapa 2: criar um documento e CustomXmlPart
Crie uma nova instância doDocument
aula e umCustomXmlPart
para armazenar os dados XML personalizados. O XML customizado deve estar em formato XML válido. Neste exemplo, usamos uma string XML simples<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>");
Etapa 3: adicionar uma StructuredDocumentTag (SDT) ao documento
Adicione umStructuredDocumentTag
ao documento para servir como controle de conteúdo. Especifique oSdtType
comoPlainText
e aMarkupLevel
comoBlock
para criar um SDT em nível de bloco.
StructuredDocumentTag sdt = new StructuredDocumentTag(doc, SdtType.PlainText, MarkupLevel.Block);
doc.FirstSection.Body.AppendChild(sdt);
Etapa 4: definir o mapeamento XML para o SDT
Mapeie o SDT para oCustomXmlPart
usando oSetMapping
método doXmlMapping
propriedade. Especifique oCustomXmlPart
, a expressão XPath para localizar o nó XML desejado e o prefixo do namespace, se necessário. Neste exemplo, mapeamos o SDT para/root[1]/text[1]
.
sdt.XmlMapping.SetMapping(xmlPart, "/root[1]/text[1]", "");
Etapa 5: salve o documento
Salve o documento modificado no diretório especificado usando oSave
método. Forneça o nome de arquivo desejado com a extensão de arquivo apropriada. Neste exemplo, salvamos o documento como “WorkingWithSdt.BindSDTtoCustomXmlPart.doc”.
doc.Save(dataDir + "WorkingWithSdt.BindSDTtoCustomXmlPart.doc");
Exemplo de código-fonte para Bind Sd Tto Custom Xml Part usando Aspose.Words for .NET
// Caminho para o diretório do seu documento
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");
É isso! Você vinculou com êxito um SDT a um CustomXmlPart em seu documento do Word usando Aspose.Words for .NET.