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 seja possível localizar e remover dados não utilizados, como estilos ou listas, ou duplicar informações manualmente, será muito mais conveniente fazer isso usando recursos e capacidades fornecidos por 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, pode utilizar 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-C
auto doc = MakeObject<Document>(MyDir + u"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.
std::cout << (String::Format(u"Count of styles before Cleanup: {0}\n", doc->get_Styles()->get_Count()) +
              String::Format(u"Count of lists before Cleanup: {0}", doc->get_Lists()->get_Count()))
          << std::endl;

// Cleans unused styles and lists from the document depending on given CleanupOptions.
auto cleanupOptions = MakeObject<CleanupOptions>();
cleanupOptions->set_UnusedLists(false);
cleanupOptions->set_UnusedStyles(true);
doc->Cleanup(cleanupOptions);

std::cout << (String::Format(u"Count of styles after Cleanup was decreased: {0}\n", doc->get_Styles()->get_Count()) +
              String::Format(u"Count of lists after Cleanup is the same: {0}", doc->get_Lists()->get_Count()))
          << std::endl;

doc->Save(ArtifactsDir + u"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-C
auto doc = MakeObject<Document>(MyDir + u"Document.docx");

// Count of styles before Cleanup.
std::cout << doc->get_Styles()->get_Count() << std::endl;

// Cleans duplicate styles from the document.
auto options = MakeObject<CleanupOptions>();
options->set_DuplicateStyle(true);
doc->Cleanup(options);

// Count of styles after Cleanup was decreased.
std::cout << doc->get_Styles()->get_Count() << std::endl;

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