Especifique as opções de salvamento
Ao salvar um documento, você pode definir algumas propriedades avançadas. Aspose.Words fornece a classe SaveOptions, que permite um controle mais preciso do processo de salvamento. Existem sobrecargas do método Save que aceita um objeto SaveOptions – ele deve ser um objeto de uma classe derivada da classe SaveOptions. Cada formato de salvamento possui uma classe correspondente que contém opções de salvamento para esse formato de salvamento, por exemplo, há PdfSaveOptions para salvar no formato PDF, MarkdownSaveOptions para salvar no formato Markdown ou ImageSaveOptions para salvar em uma imagem. Este artigo fornece exemplos de como trabalhar com algumas classes de opções derivadas de SaveOptions.
O exemplo de código a seguir mostra como definir as opções de salvamento antes de salvar o documento em HTML:
O artigo descreve algumas propriedades que você pode controlar ao salvar um documento.
Criptografar um documento com uma senha
Use a propriedade Password para obter ou definir uma senha para um documento criptografado. Use a propriedade Password da classe correspondente para trabalhar com o formato de documento selecionado.
Por exemplo, ao salvar um documento no formato DOC ou DOT, use a propriedade Password da classe DocSaveOptions.
O exemplo de código a seguir mostra como definir uma senha para criptografar um documento usando o método de criptografia RC4:
Ao salvar um documento no formato Odt, use a propriedade Password da classe OdtSaveOptions.
O exemplo de código a seguir mostra como carregar e salvar OpenDocument criptografado com uma senha:
Nem todos os formatos suportam criptografia e uso de propriedade Password.
Mostrar notificações de progresso de salvamento de documentos
Aspose.Words oferece a capacidade de usar a propriedade ProgressCallback para receber notificações sobre o andamento do salvamento do documento.
Agora está disponível ao salvar nos formatos DOCX, FlatOpc, DOCM, DOTM, DOTX, HTML, MHTML, EPUB, XamlFlow, XamlFlowPack ou TXT.
Atualizar o horário de criação do documento
Aspose.Words oferece a capacidade de usar a propriedade CreatedTime para obter ou definir a data de criação do documento em UTC. Você também pode atualizar esse valor antes de salvar usando a opção UpdateCreatedTimeProperty.
O exemplo de código a seguir mostra como atualizar o horário de criação do documento:
Atualizar última propriedade salva
Aspose.Words fornece a capacidade de usar a propriedade UpdateLastSavedTimeProperty para obter ou definir um valor que determina se a propriedade LastSavedTime é atualizada antes de salvar.
O exemplo de código a seguir mostra como definir essa propriedade e salvar o documento:
Controle recursos externos ao salvar um documento em HTML ou SVG
Para converter HTML ou SVG em PDF, basta invocar o método Save e especificar um nome de arquivo com extensão “.PDF”. Se quiser carregar imagens, CSS, etc. de fontes externas, você pode usar IResourceSavingCallback.
O exemplo de código a seguir mostra como converter HTML em PDF e carregar imagens de fontes externas:
Salvar imagem em preto e branco com formato de um bit por pixel
Para controlar as opções de salvamento de imagens, a classe ImageSaveOptions é usada. Por exemplo, você pode usar a propriedade PixelFormat para definir o formato de pixel das imagens geradas. Observe que o formato de pixel da imagem de saída pode diferir do valor definido devido ao trabalho do GDI+.
O exemplo de código a seguir mostra como salvar uma imagem em preto e branco com formato de um bit por pixel: