Вкажіть параметри збереження

При збереженні документа ви можете встановити додаткові властивості. Aspose.Words Ви з SaveOptions клас, який дозволяє більш точний контроль процесу збереження. Є перевантаження Save метод, який приймає SaveOptions об’єкт – він повинен бути об’єктом класу, отриманим від SaveOptions клас. Кожен формат збереження має відповідний клас, який зберігає параметри для цього формату збереження, наприклад, є PdfSaveOptions для збереження у форматі PDF, MarkdownSaveOptions для економії Markdown формат, або ImageSaveOptions для збереження зображення. У статті наведено приклади роботи з деякими способами, отримані з SaveOptionsй

Приклад коду показує, як встановити параметри збереження перед збереженням документа в HTML:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET
// The path to the documents directory.
string dataDir = RunExamples.GetDataDir_LoadingAndSaving();

string fileName = "TestFile RenderShape.docx";

Document doc = new Document(dataDir + fileName);

// This is the directory we want the exported images to be saved to.
string imagesDir = Path.Combine(dataDir, "Images");

// The folder specified needs to exist and should be empty.
if (Directory.Exists(imagesDir))
    Directory.Delete(imagesDir, true);

Directory.CreateDirectory(imagesDir);

// Set an option to export form fields as plain text, not as HTML input elements.
HtmlSaveOptions options = new HtmlSaveOptions(SaveFormat.Html);
options.ExportTextInputFormFieldAsText = true;
options.ImagesFolder = imagesDir;

dataDir = dataDir + "Document.SaveWithOptions_out.html";
doc.Save(dataDir, options);

Ви можете завантажити файл шаблону цього прикладу з Aspose.Words GitHubй

У статті описано кілька властивостей, які ви можете контролювати при збереженні документа.

Сшифрувати документ З паролем

Використання Password майно, щоб отримати або встановити пароль для зашифрованого документа. Використання Password майно відповідного класу для роботи з вибраним форматом документа.

Наприклад, при збереженні документа в DOC або DOT формат, використання Password майно майна DocSaveOptions клас.

Приклад коду показує, як встановити пароль для шифрування документа за допомогою методу шифрування RC4:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET
Document doc = new Document(dataDir + "Document.docx");
DocSaveOptions docSaveOptions = new DocSaveOptions();
docSaveOptions.Password = "password";
dataDir = dataDir + "Document.Password_out.docx";
doc.Save(dataDir, docSaveOptions);

При збереженні документа в форматі Odt використовуйте Password майно майна OdtSaveOptions клас.

Приклад коду показує, як завантажити і зберегти OpenDocument, зашифрований паролем:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET
Document doc = new Document(dataDir + @"encrypted.odt", new Aspose.Words.LoadOptions("password"));

doc.Save(dataDir + "out.odt", new OdtSaveOptions("newpassword"));

Не всі формати підтримують шифрування і використання Password майно.

Показати документ, що заощаджує прогрес повідомлень

Aspose.Words забезпечує можливість використання ProgressCallback майно для отримання повідомлень про прогрес збереження документів.

Тепер доступна при збереженні DOCX, FlatOpc, DOCM, DOTМ, DOTEnglish, Українська, Français…

Оновлення часу створення документів

Aspose.Words забезпечує можливість використання CreatedTime майно, щоб отримати або встановити дату створення документа в UTC. Ви також можете оновити цю вартість перед збереженням UpdateCreatedTimeProperty варіант.

Приклад коду показує, як оновити час створення документа:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET
Document doc = new Document(MyDir + "Rendering.docx");

PdfSaveOptions saveOptions = new PdfSaveOptions { UpdateLastPrintedProperty = true };

doc.Save(ArtifactsDir + "WorkingWithPdfSaveOptions.UpdateIfLastPrinted.pdf", saveOptions);

Оновлення останнього заощадженого майна

Aspose.Words забезпечує можливість використання UpdateLastSavedTimeProperty майно, щоб отримати або встановити значення, визначене LastSavedTime майно оновлено до збереження.

Введіть номер мобільного, який Ви вказали при укладаннi договору з банком - для ідентифікації

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET
Document doc = new Document(dataDir + "Document.docx");

OoxmlSaveOptions ooxmlSaveOptions = new OoxmlSaveOptions();
ooxmlSaveOptions.UpdateLastSavedTimeProperty = true;

dataDir = dataDir + "UpdateLastSavedTimeProperty_out.docx";

// Save the document to disk.
doc.Save(dataDir, ooxmlSaveOptions);

Контроль зовнішніх ресурсів при збереженні документа в HTML або SVG

Щоб перетворити HTML або SVG в PDF, просто зануріть Save метод і вказати ім’я файлу з розширенням “.PDF”. Якщо ви хочете завантажувати зображення, CSS і т.д. з зовнішніх джерел можна використовувати IResourceSavingCallbackй

Приклад коду показує, як перетворити HTML в PDF і завантажувати зображення з зовнішніх джерел:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET
public class ImageLoadingWithCredentialsHandler : IResourceLoadingCallback
{
    public ImageLoadingWithCredentialsHandler()
    {
        mWebClient = new WebClient();
    }
    public ResourceLoadingAction ResourceLoading(ResourceLoadingArgs args)
    {
        if (args.ResourceType == ResourceType.Image)
        {
            Uri uri = new Uri(args.Uri);

            if (uri.Host == "www.aspose.com")
                mWebClient.Credentials = new NetworkCredential("User1", "akjdlsfkjs");
            else
                mWebClient.Credentials = new NetworkCredential("SomeOtherUserID", "wiurlnlvs");

            // Download the bytes from the location referenced by the URI.
            byte[] imageBytes = mWebClient.DownloadData(args.Uri);

            args.SetData(imageBytes);

            return ResourceLoadingAction.UserProvided;
        }
        else
        {
            return ResourceLoadingAction.Default;
        }
    }

    private WebClient mWebClient;
}

Зберегти чорний і білий зображення з одним бітом за формат пікселя

Щоб контролювати параметри збереження зображень, ImageSaveOptions використовується клас. Наприклад, можна використовувати PixelFormat властивість встановити формат пікселя для створених зображень. Будь ласка, зверніть увагу, що формат піксельного зображення може відрізнятися від встановленого значення через роботу GDI+.

Приклад коду показує, як зберегти чорно-біле зображення з одним бітом за форматом пікселів:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET
ImageSaveOptions opt = new ImageSaveOptions(SaveFormat.Png);
            
PageSet pageSet = new PageSet(new PageRange(1, 1));
opt.PageSet = pageSet;
opt.ImageColorMode = ImageColorMode.BlackAndWhite;
opt.PixelFormat = ImagePixelFormat.Format1bppIndexed;

dataDir = dataDir + "Format1bppIndexed_Out.Png";
doc.Save(dataDir, opt);