Zadejte možnosti uložení

Při ukládání dokumentu můžete nastavit některé pokročilé vlastnosti. Aspose.Words poskytuje vám SaveOptions třída, která umožňuje přesnější řízení procesu uložení. Jsou tu přetížení. Save metoda, která přijímá SaveOptions Objekt: SaveOptions třída. Každý formát uložení má odpovídající třídu, která drží možnosti uložení pro tento formát uložení, například, tam je PdfSaveOptions pro uložení do formátu PDF, MarkdownSaveOptions pro úsporu na Markdown formát nebo ImageSaveOptions za záchranu obrazu. Tento článek uvádí 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-.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);

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

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

Zašifrovat dokument S heslem

Použijte Password vlastnost získat nebo nastavit heslo pro zašifrovaný dokument. Použijte Password vlastnost odpovídající třídy pracovat s vybraným formátem dokumentu.

Například při ukládání dokumentu do DOC nebo DOT formát, použijte Password majetek DocSaveOptions třída.

Následující příklad kódu ukazuje, jak nastavit heslo pro šifrování dokumentu pomocí šifrovací metody 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);

Při ukládání dokumentu do formátu Odt použijte Password majetek OdtSaveOptions třída.

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

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

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

Zobrazit oznámení o uložení dokumentu

Aspose.Words poskytuje schopnost používat ProgressCallback vlastnost získat oznámení o průběhu ukládání dokumentů.

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

Aktualizovat čas vytvoření dokumentu

Aspose.Words poskytuje schopnost užívat CreatedTime vlastnost získat nebo nastavit datum vytvoření dokumentu v UTC. Tuto hodnotu můžete také aktualizovat před uložením UpdateCreatedTimeProperty Možnost.

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-.NET
Document doc = new Document(MyDir + "Rendering.docx");

PdfSaveOptions saveOptions = new PdfSaveOptions { UpdateLastPrintedProperty = true };

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

Aktualizovat naposledy uložená vlastnost

Aspose.Words poskytuje schopnost užívat UpdateLastSavedTimeProperty vlastnost získat nebo nastavit hodnotu určující, zda LastSavedTime vlastnost je 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-.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);

Ovládání externích zdrojů Při ukládání dokumentu do HTML nebo SVG

Chcete-li převést HTML nebo SVG do PDF, jednoduše použít Save metoda a zadejte název souboru s příponou PDF. Pokud chcete načíst obrázky, CSS, atd. z externích zdrojů, můžete použít IResourceSavingCallback.

Následující příklad kódu ukazuje, jak převést HTML do PDF a načítá obrázky z externích zdrojů:

// 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;
}

Uložit černou a bílou obrázek s jedním bit na formát Pixel

Pro kontrolu možností ukládání obrazu ImageSaveOptions Hodina se používá. Například můžete použít PixelFormat vlastnost nastavit formát pixelů pro generované obrázky. Vezměte prosím na vědomí, že formát pixelů výstupního obrazu se může v důsledku práce GDI+ lišit od nastavené hodnoty.

Následující příklad kódu ukazuje, jak uložit černobílý obraz s jedním bitem na formát pixelů:

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