HtmlSaveOptions Class

public class HtmlSaveOptions : SaveOptions

Public Class HtmlSaveOptions
	Inherits SaveOptions

public ref class HtmlSaveOptions : public SaveOptions

type HtmlSaveOptions =  
    class
        inherit SaveOptions
    end

Document doc = new Document(MyDir + "Rendering.docx");

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

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

doc.Save(ArtifactsDir + "Document.SaveHtmlWithOptions.html", options);

// Open an existing document from disk
Document doc = new Document(MyDir + "Rendering.docx");

// Create a new instance of HtmlSaveOptions. This object allows us to set options that control
// how the output document is saved
HtmlSaveOptions saveOptions = new HtmlSaveOptions();

// Specify the desired encoding.
saveOptions.Encoding = Encoding.UTF8;

// Specify at what elements to split the internal HTML at. This creates a new HTML within the EPUB 
// which allows you to limit the size of each HTML part. This is useful for readers which cannot read 
// HTML files greater than a certain size e.g 300kb
saveOptions.DocumentSplitCriteria = DocumentSplitCriteria.HeadingParagraph;

// Specify that we want to export document properties
saveOptions.ExportDocumentProperties = true;

// Specify that we want to save in EPUB format
saveOptions.SaveFormat = SaveFormat.Epub;

// Export the document as an EPUB file
doc.Save(ArtifactsDir + "Document.Doc2EpubSaveOptions.epub", saveOptions);

public void DocumentParts()
{
    // Open a document to be converted to html
    Document doc = new Document(MyDir + "Rendering.docx");
    string outFileName = "SavingCallback.DocumentParts.Rendering.html";

    // We can use an appropriate SaveOptions subclass to customize the conversion process
    HtmlSaveOptions options = new HtmlSaveOptions();

    // We can use it to split a document into smaller parts, in this instance split by section breaks
    // Each part will be saved into a separate file, creating many files during the conversion process instead of just one
    options.DocumentSplitCriteria = DocumentSplitCriteria.SectionBreak;

    // We can set a callback to name each document part file ourselves
    options.DocumentPartSavingCallback = new SavedDocumentPartRename(outFileName, options.DocumentSplitCriteria);

    // If we convert a document that contains images into html, we will end up with one html file which links to several images
    // Each image will be in the form of a file in the local file system
    // There is also a callback that can customize the name and file system location of each image
    options.ImageSavingCallback = new SavedImageRename(outFileName);

    // The DocumentPartSaving() and ImageSaving() methods of our callbacks will be run at this time
    doc.Save(ArtifactsDir + outFileName, options);
}

/// <summary>
/// Renames saved document parts that are produced when an HTML document is saved while being split according to a criteria.
/// </summary>
private class SavedDocumentPartRename : IDocumentPartSavingCallback
{
    public SavedDocumentPartRename(string outFileName, DocumentSplitCriteria documentSplitCriteria)
    {
        mOutFileName = outFileName;
        mDocumentSplitCriteria = documentSplitCriteria;
    }

    void IDocumentPartSavingCallback.DocumentPartSaving(DocumentPartSavingArgs args)
    {
        Assert.True(args.Document.OriginalFileName.EndsWith("Rendering.docx"));

        string partType = "";

        switch (mDocumentSplitCriteria)
        {
            case DocumentSplitCriteria.PageBreak:
                partType = "Page";
                break;
            case DocumentSplitCriteria.ColumnBreak:
                partType = "Column";
                break;
            case DocumentSplitCriteria.SectionBreak:
                partType = "Section";
                break;
            case DocumentSplitCriteria.HeadingParagraph:
                partType = "Paragraph from heading";
                break;
        }

        string partFileName = $"{mOutFileName} part {++mCount}, of type {partType}{Path.GetExtension(args.DocumentPartFileName)}";

        // We can designate the filename and location of each output file either by filename
        args.DocumentPartFileName = partFileName;

        // Or we can make a new stream and choose the location of the file at construction
        args.DocumentPartStream = new FileStream(ArtifactsDir + partFileName, FileMode.Create);
        Assert.True(args.DocumentPartStream.CanWrite);
        Assert.False(args.KeepDocumentPartStreamOpen);
    }

    private int mCount;
    private readonly string mOutFileName;
    private readonly DocumentSplitCriteria mDocumentSplitCriteria;
}

/// <summary>
/// Renames saved images that are produced when an HTML document is saved.
/// </summary>
public class SavedImageRename : IImageSavingCallback
{
    public SavedImageRename(string outFileName)
    {
        mOutFileName = outFileName;
    }

    void IImageSavingCallback.ImageSaving(ImageSavingArgs args)
    {
        // Same filename and stream functions as above in IDocumentPartSavingCallback apply here
        string imageFileName = $"{mOutFileName} shape {++mCount}, of type {args.CurrentShape.ShapeType}{Path.GetExtension(args.ImageFileName)}";

        args.ImageFileName = imageFileName;

        args.ImageStream = new FileStream(ArtifactsDir + imageFileName, FileMode.Create);
        Assert.True(args.ImageStream.CanWrite);
        Assert.True(args.IsImageAvailable);
        Assert.False(args.KeepImageStreamOpen);
    }

    private int mCount;
    private readonly string mOutFileName;
}