Especificar opciones de guardar

Al guardar un documento, puede configurar algunas propiedades avanzadas. Aspose.Words le proporciona la clase SaveOptions, que permite un control más preciso del proceso de guardado. Hay sobrecargas del método Save que acepta un objeto SaveOptions; debería ser un objeto de una clase derivada de la clase SaveOptions. Cada formato de guardado tiene una clase correspondiente que contiene opciones de guardado para este formato de guardado, por ejemplo, hay PdfSaveOptions para guardar en formato PDF, MarkdownSaveOptions para guardar en formato Markdown u ImageSaveOptions para guardar en una imagen. Este artículo proporciona ejemplos de cómo trabajar con algunas clases de opciones derivadas de SaveOptions.

El siguiente ejemplo de código muestra cómo configurar las opciones de guardar antes de guardar el documento en HTML:

El artículo describe algunas propiedades que puede controlar al guardar un documento.

Cifrar un documento con una contraseña

Utilice la propiedad Password para obtener o establecer una contraseña para un documento cifrado. Utilice la propiedad Password de la clase correspondiente para trabajar con el formato de documento seleccionado.

Por ejemplo, al guardar un documento en formato DOC o DOT, utilice la propiedad Password de la clase DocSaveOptions.

El siguiente ejemplo de código muestra cómo establecer una contraseña para cifrar un documento utilizando el método de cifrado RC4:

Al guardar un documento en formato Odt, utilice la propiedad Password de la clase OdtSaveOptions.

El siguiente ejemplo de código muestra cómo cargar y guardar OpenDocument cifrado con una contraseña:

No todos los formatos admiten el cifrado y el uso de la propiedad Password.

Mostrar notificaciones de progreso de guardado de documentos

Aspose.Words brinda la posibilidad de utilizar la propiedad ProgressCallback para recibir notificaciones sobre el progreso del guardado del documento.

Ahora está disponible al guardar en formatos DOCX, FlatOpc, DOCM, DOTM, DOTX, HTML, MHTML, EPUB, XamlFlow, XamlFlowPack o TXT.

Actualizar la hora de creación del documento

Aspose.Words ofrece la posibilidad de utilizar la propiedad CreatedTime para obtener o establecer la fecha de creación del documento en UTC. También puede actualizar este valor antes de guardarlo usando la opción UpdateCreatedTimeProperty.

El siguiente ejemplo de código muestra cómo actualizar la hora de creación del documento:

Actualizar la última propiedad guardada

Aspose.Words ofrece la posibilidad de utilizar la propiedad UpdateLastSavedTimeProperty para obtener o establecer un valor que determine si la propiedad LastSavedTime se actualiza antes de guardar.

El siguiente ejemplo de código muestra cómo establecer esta propiedad y guardar el documento:

Controle los recursos externos al guardar un documento en HTML o SVG

Para convertir HTML o SVG a PDF, simplemente invoque el método Save y especifique un nombre de archivo con la extensión “.PDF”. Si desea cargar imágenes, CSS, etc. desde fuentes externas, puede utilizar IResourceSavingCallback.

El siguiente ejemplo de código muestra cómo convertir HTML a PDF y cargar imágenes de fuentes externas:

Guarde una imagen en blanco y negro con formato de un bit por píxel

Para controlar las opciones de guardado de imágenes, se utiliza la clase ImageSaveOptions. Por ejemplo, puede utilizar la propiedad PixelFormat para establecer el formato de píxeles de las imágenes generadas. Tenga en cuenta que el formato de píxeles de la imagen de salida puede diferir del valor establecido debido al trabajo de GDI+.

El siguiente ejemplo de código muestra cómo guardar una imagen en blanco y negro con un formato de bit por píxel: