Určete Možnosti Uložení

Při ukládání dokumentu můžete nastavit některé pokročilé vlastnosti. Aspose.Words vám poskytuje třídu SaveOptions, která umožňuje přesnější řízení procesu ukládání. Existují přetížení metody Save, které přijímají objekt SaveOptions - měl by to být objekt třídy odvozený od třídy SaveOptions. Každý formát uložení má odpovídající třídu, která obsahuje možnosti uložení pro tento formát uložení, například existuje PdfSaveOptions pro uložení do formátu PDF, MarkdownSaveOptions pro uložení do formátu Markdown nebo ImageSaveOptions pro uložení do obrázku. Tento článek poskytuje příklady práce s některými třídami možností odvozenými z SaveOptions.

Následující příklad kódu ukazuje, jak nastavit možnosti uložení před uložením dokumentu do HTML:

For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-C
// The path to the documents directories.
System::String inputDataDir = GetInputDataDir_LoadingAndSaving();
System::String outputDataDir = GetOutputDataDir_LoadingAndSaving();

System::SharedPtr<Document> doc = System::MakeObject<Document>(inputDataDir + u"TestFile RenderShape.docx");

// This is the directory we want the exported images to be saved to.
System::String imagesDir = System::IO::Path::Combine(outputDataDir, u"SpecifySaveOption.Images");

// The folder specified needs to exist and should be empty.
if (System::IO::Directory::Exists(imagesDir))
{
    System::IO::Directory::Delete(imagesDir, true);
}
System::IO::Directory::CreateDirectory_(imagesDir);

// Set an option to export form fields as plain text, not as HTML input elements.
System::SharedPtr<HtmlSaveOptions> options = System::MakeObject<HtmlSaveOptions>(SaveFormat::Html);
options->set_ExportTextInputFormFieldAsText(true);
options->set_ImagesFolder(imagesDir);

System::String outputPath = outputDataDir + u"SpecifySaveOption.html";
doc->Save(outputPath, options);

Soubor šablony tohoto příkladu si můžete stáhnout z Aspose.Words GitHub.

Článek popisuje několik vlastností, které můžete ovládat při ukládání dokumentu.

Zašifrujte dokument heslem

Pomocí vlastnosti Password získáte nebo nastavíte heslo pro šifrovaný dokument. Pro práci s vybraným formátem dokumentu použijte vlastnost Password odpovídající třídy.

Například při ukládání dokumentu do formátu DOC nebo DOT použijte vlastnost Password třídy DocSaveOptions.

Následující příklad kódu ukazuje, jak nastavit heslo pro šifrování dokumentu pomocí metody šifrování RC4:

For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-C
System::SharedPtr<Document> doc = System::MakeObject<Document>(inputDataDir + u"Document.doc");
System::SharedPtr<DocSaveOptions> docSaveOptions = System::MakeObject<DocSaveOptions>();
docSaveOptions->set_Password(u"password");
System::String outputPath = outputDataDir + u"WorkingWithDoc.EncryptDocumentWithPassword.doc";
doc->Save(outputPath, docSaveOptions);

Při ukládání dokumentu do formátu ODT Použijte vlastnost Password třídy OdtSaveOptions.

Následující příklad kódu ukazuje, jak načíst a uložit OpenDocument šifrované heslem:

For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-C
System::SharedPtr<Document> doc = System::MakeObject<Document>(inputDataDir + u"encrypted.odt", System::MakeObject<LoadOptions>(u"password"));

System::String outputPath = outputDataDir + u"Load_Options.LoadAndSaveEncryptedODT.odt";
doc->Save(outputPath, System::MakeObject<OdtSaveOptions>(u"newpassword"));

Ne všechny formáty podporují šifrování a použití vlastnosti Password.

Zobrazit Oznámení O Průběhu Ukládání Dokumentů

Aspose.Words poskytuje možnost používat vlastnost ProgressCallback k získávání oznámení o průběhu ukládání dokumentů.

Nyní je k dispozici při ukládání do DOCX, FlatOpc, DOCM, DOTM, DOTX, HTML, MHTML, EPUB, XamlFlow, XamlFlowPack, nebo TXT formáty.

Aktualizujte čas vytvoření dokumentu

Aspose.Words poskytuje možnost použít vlastnost CreatedTime k získání nebo nastavení data vytvoření dokumentu v UTC. Tuto hodnotu můžete také aktualizovat před uložením pomocí možnosti UpdateCreatedTimeProperty.

Následující příklad kódu ukazuje, jak aktualizovat čas vytvoření dokumentu:

For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-C
// Open a document
System::SharedPtr<Document> doc = System::MakeObject<Document>(inputDataDir + u"TestFile.docx");

System::SharedPtr<SaveOptions> options = System::MakeObject<PdfSaveOptions>();
options->set_UpdateLastPrintedProperty(false);

System::String outputPath = outputDataDir + u"WorkingWithPdfSaveOptions.UpdateIfLastPrinted.pdf";
doc->Save(outputPath, options);

Aktualizovat Poslední Uloženou Vlastnost

Aspose.Words poskytuje možnost použít vlastnost UpdateLastSavedTimeProperty k získání nebo nastavení hodnoty určující, zda je vlastnost LastSavedTime aktualizována před uložením.

Následující příklad kódu ukazuje, jak nastavit tuto vlastnost a uložit dokument:

For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-C
System::SharedPtr<Document> doc = System::MakeObject<Document>(inputDataDir + u"Document.doc");

System::SharedPtr<OoxmlSaveOptions> ooxmlSaveOptions = System::MakeObject<OoxmlSaveOptions>();
ooxmlSaveOptions->set_UpdateLastSavedTimeProperty(true);

System::String outputPath = outputDataDir + u"WorkingWithOoxml.UpdateLastSavedTimeProperty.docx";
// Save the document to disk.
doc->Save(outputPath, ooxmlSaveOptions);

Uložte černobílý obrázek ve formátu jeden Bit na Pixel

K ovládání možností ukládání obrázků se používá třída ImageSaveOptions. Můžete například použít vlastnost PixelFormat k nastavení formátu pixelů pro generované obrázky. Vezměte prosím na vědomí, že formát Pixelů výstupního obrazu se může lišit od nastavené hodnoty kvůli práci GDI+.

Následující příklad kódu ukazuje, jak uložit černobílý obrázek ve formátu jeden bit na pixel:

For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-C
System::SharedPtr<ImageSaveOptions> opt = System::MakeObject<ImageSaveOptions>(SaveFormat::Png);

auto pageSet = System::MakeObject<PageSet>(System::MakeArray<System::SharedPtr<PageRange>>({System::MakeObject<PageRange>(1,1)}));
opt->set_PageSet(pageSet);

opt->set_ImageColorMode(ImageColorMode::BlackAndWhite);
opt->set_PixelFormat(ImagePixelFormat::Format1bppIndexed);

System::String outputPath = outputDataDir + u"ImageColorFilters.SaveImageToOnebitPerPixel.png";
doc->Save(outputPath, opt);