Clonar um documento
Clonar um documento é o processo de criação de uma cópia idêntica de um documento original, o que pode melhorar o desempenho e evitar possíveis vazamentos de memória.
Este artigo explicará os principais casos de uso de clonagem de um documento e como criar um clone de documento usando Aspose.Words.
Operações com Clonagem de Documentos
A operação de clonagem permite agilizar o processo de criação de documentos, pois você não precisará carregar e analisar um documento de um arquivo todas as vezes.
Após criar um clone do seu documento, você poderá editá-lo e realizar diversas operações nele, por exemplo, compará-lo com o documento original, anexá-lo ou inseri-lo em outro documento. Você também pode modificar os elementos clonados ou seu conteúdo antes de inseri-los em outro documento.
Criando um clone de documento
Aspose.Words permite clonar um documento usando o método Clone que realiza uma cópia profunda do documento e o retorna. Em outras palavras, obterá uma cópia completa do DOM. O método Clone acelera a geração de documentos e você só precisa de uma linha de código para obter uma cópia do seu documento.
A clonagem produz um novo documento com o mesmo conteúdo do original, mas com uma cópia exclusiva de cada nodes do documento original. Você também pode aplicar a operação de clonagem a um nó de documento usando o método node Clone, que permite duplicar nós de documento composto com e sem seus nós filhos.
O exemplo de código a seguir mostra como clonar um documento e criar uma duplicata de uma seção nesse documento:
// Create a document.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
builder.Writeln("This is the original document before applying the clone method");
// Clone the document.
Document clone = doc.Clone();
// Edit the cloned document.
DocumentBuilder builder = new DocumentBuilder(clone);
builder.Write("Section 1");
builder.InsertBreak(BreakType.SectionBreakNewPage);
builder.Write("Section 2");
// This shows what is in the document originally. The document has two sections.
Assert.AreEqual("Section 1\x000cSection 2", clone.GetText().Trim());
// Duplicate the last section and append the copy to the end of the document.
int lastSectionIdx = clone.Sections.Count - 1;
Section newSection = clone.Sections[lastSectionIdx].Clone();
clone.Sections.Add(newSection);
// Check what the document contains after we changed it.
Assert.AreEqual("Section 1\x000cSection 2", clone.GetText().Trim());