Limpar um documento

Às vezes, pode ser necessário remover informações não utilizadas ou duplicadas para reduzir o tamanho do documento de saída e o tempo de processamento.

Embora você possa localizar e remover dados não utilizados, como estilos ou listas, ou duplicar informações manualmente, será muito mais conveniente fazer isso usando os recursos e capacidades fornecidos pelo Aspose.Words.

A classe CleanupOptions permite especificar opções para limpeza de documentos. Para remover estilos duplicados ou apenas estilos ou listas não utilizados do documento, você pode usar o método Cleanup.

Remover informações não utilizadas de um documento

Você pode usar as propriedades UnusedStyles e UnusedBuiltinStyles para detectar e remover estilos marcados como “não utilizados”.

Você pode usar a propriedade UnusedLists para detectar e remover listas e definições de lista marcadas como “não utilizadas”.

O exemplo de código a seguir mostra como remover apenas estilos não utilizados de um documento:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET
Document doc = new Document(MyDir + "Unused styles.docx");

// Combined with the built-in styles, the document now has eight styles.
// A custom style is marked as "used" while there is any text within the document
// formatted in that style. This means that the 4 styles we added are currently unused.
Console.WriteLine($"Count of styles before Cleanup: {doc.Styles.Count}\n" +
                  $"Count of lists before Cleanup: {doc.Lists.Count}");

// Cleans unused styles and lists from the document depending on given CleanupOptions. 
CleanupOptions cleanupOptions = new CleanupOptions { UnusedLists = false, UnusedStyles = true };
doc.Cleanup(cleanupOptions);

Console.WriteLine($"Count of styles after Cleanup was decreased: {doc.Styles.Count}\n" +
                  $"Count of lists after Cleanup is the same: {doc.Lists.Count}");

doc.Save(ArtifactsDir + "WorkingWithDocumentOptionsAndSettings.CleanupUnusedStylesAndLists.docx");

Remover informações duplicadas de um documento

Você também pode usar a propriedade DuplicateStyle para substituir todos os estilos duplicados pelo original e remover duplicatas de um documento.

O exemplo de código a seguir mostra como remover estilos duplicados de um documento:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET
Document doc = new Document(MyDir + "Document.docx");

// Count of styles before Cleanup.
Console.WriteLine(doc.Styles.Count);

// Cleans duplicate styles from the document.
CleanupOptions options = new CleanupOptions { DuplicateStyle = true };
doc.Cleanup(options);

// Count of styles after Cleanup was decreased.
Console.WriteLine(doc.Styles.Count);

doc.Save(ArtifactsDir + "WorkingWithDocumentOptionsAndSettings.CleanupDuplicateStyle.docx");