Specificare le opzioni di salvataggio

Quando salvi un documento, puoi impostare alcune proprietà avanzate. Aspose.Words fornisce la classe SaveOptions, che consente un controllo più preciso del processo di salvataggio. Esistono sovraccarichi del metodo Save che accettano un oggetto SaveOptions: dovrebbe essere un oggetto di una classe derivata dalla classe SaveOptions. Ogni formato di salvataggio ha una classe corrispondente che contiene le opzioni di salvataggio per questo formato di salvataggio, ad esempio c’è PdfSaveOptions per il salvataggio in formato PDF, MarkdownSaveOptions per il salvataggio in formato Markdown o ImageSaveOptions per il salvataggio in un’immagine. Questo articolo fornisce esempi di utilizzo di alcune classi di opzioni derivate da SaveOptions.

Il seguente esempio di codice mostra come impostare le opzioni di salvataggio prima di salvare il documento in HTML:

L’articolo descrive alcune proprietà che puoi controllare quando salvi un documento.

Crittografa un documento con una password

Utilizza la proprietà Password per ottenere o impostare una password per un documento crittografato. Utilizza la proprietà Password della classe corrispondente per lavorare con il formato del documento selezionato.

Ad esempio, quando si salva un documento in formato DOC o DOT, utilizzare la proprietà Password della classe DocSaveOptions.

Il seguente esempio di codice mostra come impostare una password per crittografare un documento utilizzando il metodo di crittografia RC4:

Quando si salva un documento in formato Odt, utilizzare la proprietà Password della classe OdtSaveOptions.

Il seguente esempio di codice mostra come caricare e salvare OpenDocument crittografato con una password:

Non tutti i formati supportano la crittografia e l’uso della proprietà Password.

Mostra le notifiche di avanzamento del salvataggio del documento

Aspose.Words offre la possibilità di utilizzare la proprietà ProgressCallback per ricevere notifiche sull’avanzamento del salvataggio del documento.

Ora è disponibile quando si salva nei formati DOCX, FlatOpc, DOCM, DOTM, DOTX, HTML, MHTML, EPUB, XamlFlow, XamlFlowPack o TXT.

Aggiorna l’ora di creazione del documento

Aspose.Words offre la possibilità di utilizzare la proprietà CreatedTime per ottenere o impostare la data di creazione del documento in UTC. Puoi anche aggiornare questo valore prima di salvare utilizzando l’opzione UpdateCreatedTimeProperty.

L’esempio di codice seguente mostra come aggiornare l’ora di creazione del documento:

Aggiorna l’ultima proprietà salvata

Aspose.Words offre la possibilità di utilizzare la proprietà UpdateLastSavedTimeProperty per ottenere o impostare un valore che determina se la proprietà LastSavedTime viene aggiornata prima del salvataggio.

L’esempio di codice seguente mostra come impostare questa proprietà e salvare il documento:

Controlla le risorse esterne durante il salvataggio di un documento in HTML o SVG

Per convertire HTML o SVG in PDF, richiama semplicemente il metodo Save e specifica un nome file con l’estensione “.PDF”. Se desideri caricare immagini, CSS, ecc. Da fonti esterne, puoi utilizzare IResourceSavingCallback.

Il seguente esempio di codice mostra come convertire HTML in PDF e caricare immagini da fonti esterne:

Salva immagine in bianco e nero con formato un bit per pixel

Per controllare le opzioni di salvataggio delle immagini, viene utilizzata la classe ImageSaveOptions. Ad esempio, puoi utilizzare la proprietà PixelFormat per impostare il formato pixel per le immagini generate. Tieni presente che il formato in pixel dell’immagine di output potrebbe differire dal valore impostato a causa del lavoro di GDI+.

Il seguente esempio di codice mostra come salvare un’immagine in bianco e nero con il formato un bit per pixel: