Speicheroptionen angeben

Beim Speichern eines Dokuments können Sie einige erweiterte Eigenschaften festlegen. Aspose.Words stellt Ihnen die Klasse SaveOptions zur Verfügung, die eine genauere Steuerung des Speichervorgangs ermöglicht. Es gibt Überladungen der Save -Methode, die ein SaveOptions –Objekt akzeptieren - es sollte ein Objekt einer Klasse sein, die von der SaveOptions -Klasse abgeleitet ist. Jedes Speicherformat hat eine entsprechende Klasse, die Speicheroptionen für dieses Speicherformat enthält, z. B. gibt es PdfSaveOptions zum Speichern im PDF -Format, MarkdownSaveOptions zum Speichern im Markdown -Format oder ImageSaveOptions zum Speichern in ein Bild. Dieser Artikel enthält Beispiele für die Arbeit mit einigen von SaveOptions abgeleiteten Optionsklassen.

Das folgende Codebeispiel zeigt, wie Sie die Speicheroptionen festlegen, bevor Sie das Dokument in HTML speichern:

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);

Sie können die Vorlagendatei dieses Beispiels herunterladen von Aspose.Words GitHub.

Der Artikel beschreibt einige Eigenschaften, die Sie beim Speichern eines Dokuments steuern können.

Verschlüsseln Sie ein Dokument mit einem Kennwort

Verwenden Sie die Eigenschaft Password, um ein Kennwort für ein verschlüsseltes Dokument abzurufen oder festzulegen. Verwenden Sie die Eigenschaft Password der entsprechenden Klasse, um mit dem ausgewählten Dokumentformat zu arbeiten.

Wenn Sie beispielsweise ein Dokument im Format DOC oder DOT speichern, verwenden Sie die Eigenschaft Password der Klasse DocSaveOptions.

Das folgende Codebeispiel zeigt, wie Sie ein Kennwort festlegen, um ein Dokument mit der Verschlüsselungsmethode RC4 zu verschlüsseln:

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);

Verwenden Sie beim Speichern eines Dokuments im Format ODT die Eigenschaft Password der Klasse OdtSaveOptions.

Das folgende Codebeispiel zeigt, wie OpenDocument mit einem Kennwort verschlüsselt geladen und gespeichert wird:

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"));

Nicht alle Formate unterstützen die Verschlüsselung und die Verwendung der Eigenschaft Password.

Fortschrittsbenachrichtigungen zum Speichern von Dokumenten anzeigen

Aspose.Words bietet die Möglichkeit, die Eigenschaft ProgressCallback zu verwenden, um Benachrichtigungen über den Fortschritt der Dokumentenspeicherung zu erhalten.

Es ist jetzt beim Speichern in verfügbar DOCX, FlatOpc, DOCM, DOTM, DOTX, HTML, MHTML, EPUB, XamlFlow, XamlFlowPack, oder TXT-Formate.

Aktualisieren Sie die Erstellungszeit des Dokuments

Aspose.Words bietet die Möglichkeit, die Eigenschaft CreatedTime zu verwenden, um das Erstellungsdatum des Dokuments in UTC abzurufen oder festzulegen. Sie können diesen Wert auch vor dem Speichern mit der Option UpdateCreatedTimeProperty aktualisieren.

Das folgende Codebeispiel zeigt, wie die Erstellungszeit des Dokuments aktualisiert wird:

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);

Zuletzt gespeicherte Eigenschaft aktualisieren

Aspose.Words bietet die Möglichkeit, die Eigenschaft UpdateLastSavedTimeProperty zu verwenden, um einen Wert abzurufen oder festzulegen, der bestimmt, ob die Eigenschaft LastSavedTime vor dem Speichern aktualisiert wird.

Das folgende Codebeispiel zeigt, wie Sie diese Eigenschaft festlegen und das Dokument speichern:

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);

Speichern Sie Schwarzweißbilder mit einem Bit pro Pixel Format

Um die Optionen zum Speichern von Bildern zu steuern, wird die Klasse ImageSaveOptions verwendet. Sie können beispielsweise die Eigenschaft PixelFormat verwenden, um das Pixelformat für die generierten Bilder festzulegen. Bitte beachten Sie, dass das Pixelformat des Ausgabebildes aufgrund der Arbeit von GDI+ vom eingestellten Wert abweichen kann.

Das folgende Codebeispiel zeigt, wie Sie ein Schwarzweißbild mit einem Bit pro Pixel-Format speichern:

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);