Pulisci un documento

A volte potrebbe essere necessario rimuovere informazioni non utilizzate o duplicate per ridurre le dimensioni del documento di output e il tempo di elaborazione.

Sebbene sia possibile trovare e rimuovere manualmente i dati inutilizzati, come stili o elenchi, o informazioni duplicate, sarà molto più conveniente farlo utilizzando le funzionalità e le funzionalità fornite da Aspose.Words.

La classe CleanupOptions consente di specificare le opzioni per la pulizia dei documenti. Per rimuovere stili duplicati o semplicemente stili o elenchi inutilizzati dal documento, puoi utilizzare il metodo cleanup.

Rimuovere le informazioni inutilizzate da un documento

Puoi utilizzare le proprietà unused_styles e unused_builtin_styles per rilevare e rimuovere gli stili contrassegnati come “non utilizzati”.

È possibile utilizzare la proprietà unused_lists per rilevare e rimuovere elenchi e definizioni di elenchi contrassegnati come “inutilizzati”.

Il seguente esempio di codice mostra come rimuovere solo gli stili inutilizzati da un documento:

# For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Python-via-.NET
doc = aw.Document(docs_base.my_dir + "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.
print(f"Count of styles before Cleanup: {doc.styles.count}\n" +
f"Count of lists before Cleanup: {doc.lists.count}")
# Cleans unused styles and lists from the document depending on given CleanupOptions.
cleanupOptions = aw.CleanupOptions()
cleanupOptions.unused_lists = False
cleanupOptions.unused_styles = True
doc.cleanup(cleanupOptions)
print(f"Count of styles after Cleanup was decreased: {doc.styles.count}\n" +
f"Count of lists after Cleanup is the same: {doc.lists.count}")
doc.save(docs_base.artifacts_dir + "WorkingWithDocumentOptionsAndSettings.cleanup_unused_styles_and_lists.docx")

Rimuovere le informazioni duplicate da un documento

Puoi anche utilizzare la proprietà duplicate_style per sostituire tutti gli stili duplicati con quello originale e rimuovere i duplicati da un documento.

L’esempio di codice seguente mostra come rimuovere gli stili duplicati da un documento:

# For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Python-via-.NET
doc = aw.Document(docs_base.my_dir + "Document.docx")
# Count of styles before Cleanup.
print(doc.styles.count)
# Cleans duplicate styles from the document.
options = aw.CleanupOptions()
options.duplicate_style = True
doc.cleanup(options)
# Count of styles after Cleanup was decreased.
print(doc.styles.count)
doc.save(docs_base.artifacts_dir + "WorkingWithDocumentOptionsAndSettings.cleanup_duplicate_style.docx")