Skip to main content

Search OfficeIMO

Enter a topic, API type, or PowerShell command.

Documentation Search all OfficeIMO/

API Reference

Class

HtmlConversionDocument

Namespace OfficeIMO.Html
Assembly OfficeIMO.Html
Source revision 804a7612eee4 with working tree changes
Modifiers sealed

Canonical OfficeIMO HTML conversion document shared by target adapters.

Inheritance

  • Object
  • HtmlConversionDocument

Usage

Explore 108 API references to this type

This type appears in these public API surfaces even when no hand-authored example is attached directly to the page.

Accepted by parameters 99

Methods

public HtmlConversionPreflight AnalyzeFor(HtmlConversionTarget target) #
Returns: HtmlConversionPreflight

Predicts supported, approximated, and omitted source features for a target before artifact creation. Results are cached per prepared document and target.

Parameters

target OfficeIMO.Html.HtmlConversionTarget requiredposition: 0
CreateDocumentForConversion 4 overloads
public HtmlDocument CreateDocumentForConversion() #
Returns: HtmlDocument

Creates an independent policy-normalized DOM for the conversion profile's default media context.

public HtmlDocument CreateDocumentForConversion(CancellationToken cancellationToken) #
Returns: HtmlDocument

Creates an independent policy-normalized DOM with cooperative cancellation.

Parameters

cancellationToken System.Threading.CancellationToken requiredposition: 0
public HtmlDocument CreateDocumentForConversion(HtmlCssMediaContext mediaContext) #
Returns: HtmlDocument

Creates a policy-normalized DOM filtered for a target media context without reparsing source HTML or mutating shared state.

Parameters

mediaContext OfficeIMO.Html.HtmlCssMediaContext requiredposition: 0
Screen or print media context selected by the target adapter.

Returns

An independent DOM clone that the target adapter may safely mutate.

public HtmlDocument CreateDocumentForConversion(HtmlCssMediaContext mediaContext, CancellationToken cancellationToken) #
Returns: HtmlDocument

Creates an independent policy-normalized DOM for the selected media context with cooperative cancellation.

Parameters

mediaContext OfficeIMO.Html.HtmlCssMediaContext requiredposition: 0
Screen or print media context selected by the target adapter.
cancellationToken System.Threading.CancellationToken requiredposition: 1
Cancels normalization, cloning, media filtering and owned-DOM projection.

Returns

An independent DOM clone that the target adapter may safely mutate.

public Task<HtmlVisibleContentResult> CreateVisibleContentDocumentResultAsync(HtmlRenderOptions? options = null, CancellationToken cancellationToken = default) #
Returns: Task<HtmlVisibleContentResult>

Creates an independent editable source without elements hidden by computed display: none, zero opacity, or a closed details element in the requested screen or print environment. The returned source keeps its original stylesheet links and bounded import contract. A supported computed image maximum width is retained as an inline hint so editable targets do not expand a captured image to its unconstrained intrinsic size.

Parameters

options OfficeIMO.Html.HtmlRenderOptions? = null optionalposition: 0
cancellationToken System.Threading.CancellationToken = default optionalposition: 1
public HtmlConversionDocument Edit(Action<HtmlDocument> edit) #
Returns: HtmlConversionDocument

Edits an independent source snapshot and retains this conversion's trust, resource and fidelity options.

Parameters

edit System.Action<OfficeIMO.Html.Dom.HtmlDocument> requiredposition: 0
public String ExportSourceHtml() #
Returns: String

Serializes the source document with its effective absolute base URI so relative references still resolve against the original location when the HTML is saved elsewhere.

FromDocument 2 overloads
public static HtmlConversionDocument FromDocument(HtmlDocument document, HtmlConversionDocumentOptions? options = null) #
Returns: HtmlConversionDocument

Creates a conversion snapshot from an owned tree without reparsing its serialized markup.

Parameters

document OfficeIMO.Html.Dom.HtmlDocument requiredposition: 0
options OfficeIMO.Html.HtmlConversionDocumentOptions? = null optionalposition: 1
public static HtmlConversionDocument FromDocument(HtmlDocument document, HtmlConversionDocumentOptions? options, CancellationToken cancellationToken) #
Returns: HtmlConversionDocument

Captures an owned tree with cooperative cancellation during validation, cloning, projection and serialization.

Parameters

document OfficeIMO.Html.Dom.HtmlDocument requiredposition: 0
options OfficeIMO.Html.HtmlConversionDocumentOptions? requiredposition: 1
cancellationToken System.Threading.CancellationToken requiredposition: 2
Load 2 overloads
public static HtmlConversionDocument Load(String path, HtmlConversionDocumentOptions? options = null, Encoding? encoding = null) #
Returns: HtmlConversionDocument

Loads and parses an HTML file.

Parameters

path System.String requiredposition: 0
options OfficeIMO.Html.HtmlConversionDocumentOptions? = null optionalposition: 1
encoding System.Text.Encoding? = null optionalposition: 2
public static HtmlConversionDocument Load(Stream stream, HtmlConversionDocumentOptions? options = null, Encoding? encoding = null) #
Returns: HtmlConversionDocument

Loads and parses HTML from a caller-owned stream.

Parameters

stream System.IO.Stream requiredposition: 0
options OfficeIMO.Html.HtmlConversionDocumentOptions? = null optionalposition: 1
encoding System.Text.Encoding? = null optionalposition: 2
LoadAsync 2 overloads
public static async Task<HtmlConversionDocument> LoadAsync(String path, HtmlConversionDocumentOptions? options = null, Encoding? encoding = null, CancellationToken cancellationToken = default) #
Returns: Task<HtmlConversionDocument>

Asynchronously loads and parses an HTML file.

Parameters

path System.String requiredposition: 0
options OfficeIMO.Html.HtmlConversionDocumentOptions? = null optionalposition: 1
encoding System.Text.Encoding? = null optionalposition: 2
cancellationToken System.Threading.CancellationToken = default optionalposition: 3
public static async Task<HtmlConversionDocument> LoadAsync(Stream stream, HtmlConversionDocumentOptions? options = null, Encoding? encoding = null, CancellationToken cancellationToken = default) #
Returns: Task<HtmlConversionDocument>

Asynchronously loads and parses HTML from a caller-owned stream.

Parameters

stream System.IO.Stream requiredposition: 0
options OfficeIMO.Html.HtmlConversionDocumentOptions? = null optionalposition: 1
encoding System.Text.Encoding? = null optionalposition: 2
cancellationToken System.Threading.CancellationToken = default optionalposition: 3
Parse 2 overloads
public static HtmlConversionDocument Parse(String html, HtmlConversionDocumentOptions? options = null) #
Returns: HtmlConversionDocument

Parses HTML and builds a shared conversion document with logical, style, resource, and normalized-output evidence.

Parameters

html System.String requiredposition: 0
options OfficeIMO.Html.HtmlConversionDocumentOptions? = null optionalposition: 1
public static HtmlConversionDocument Parse(String html, HtmlConversionDocumentOptions? options, CancellationToken cancellationToken) #
Returns: HtmlConversionDocument

Parses inert HTML with explicit cooperative cancellation.

Parameters

html System.String requiredposition: 0
options OfficeIMO.Html.HtmlConversionDocumentOptions? requiredposition: 1
cancellationToken System.Threading.CancellationToken requiredposition: 2

Properties

public String SourceHtml { get; } #

Original HTML supplied by the caller.

public HtmlDocument Document { get; } #

Owned, immutable source DOM. Access does not normalize content, fetch resources or execute scripts.

public HtmlConversionProfileContract ProfileContract { get; } #

Profile contract advertised to target adapters and galleries.

public HtmlInputTrust Trust { get; } #

Caller-assigned input trust boundary used by downstream adapters.

public HtmlLogicalDocument LogicalDocument { get; } #

Normalized logical structure used for semantic scoring and adapter planning.

public HtmlSemanticDocument SemanticDocument { get; } #

Typed semantic structure interpreted once for generic native target adapters.

public HtmlComputedStyleSummary StyleSummary { get; } #

Compact computed-style capability summary.

public HtmlResourceManifest ResourceManifest { get; } #

Raw resource manifest discovered in document order.

public HtmlResourceDependencyPlan ResourcePlan { get; } #

Resource dependency plan grouped for adapters, reports, and gallery manifests.

public Uri? BaseUri { get; } #

Effective base URI used to resolve relative resources, including a document base element when present.

public String NormalizedHtml { get; } #

Policy-aware normalized HTML, or an empty string when normalization was disabled.

public IReadOnlyList<HtmlDiagnostic> Diagnostics { get; } #

Diagnostics emitted while lazily preparing shared conversion views.

public String HtmlForConversion { get; } #

HTML text target adapters should use when no adapter-specific source preference is configured.

Extension Methods

public static OfficeImageExportResult ExportImage(HtmlConversionDocument document, OfficeImageExportFormat format, HtmlRenderOptions? options = null, Int32 pageIndex = 0) #
Returns: OfficeImageExportResult

Renders one selected surface to the requested image format with dimensions and diagnostics.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
format OfficeIMO.Drawing.OfficeImageExportFormat requiredposition: 1
options OfficeIMO.Html.HtmlRenderOptions? = null optionalposition: 2
pageIndex System.Int32 = 0 optionalposition: 3
public static async Task<OfficeImageExportResult> ExportImageAsync(HtmlConversionDocument document, OfficeImageExportFormat format, HtmlRenderOptions? options = null, Int32 pageIndex = 0, CancellationToken cancellationToken = default) #
Returns: Task<OfficeImageExportResult>

Asynchronously renders one selected surface to the requested image format.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
format OfficeIMO.Drawing.OfficeImageExportFormat requiredposition: 1
options OfficeIMO.Html.HtmlRenderOptions? = null optionalposition: 2
pageIndex System.Int32 = 0 optionalposition: 3
cancellationToken System.Threading.CancellationToken = default optionalposition: 4
ExportImages 2 overloads
public static IReadOnlyList<OfficeImageExportResult> ExportImages(HtmlConversionDocument document, OfficeImageExportFormat format, HtmlRenderOptions? options = null) #
Returns: IReadOnlyList<OfficeImageExportResult>

Renders all surfaces to the requested image format.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
format OfficeIMO.Drawing.OfficeImageExportFormat requiredposition: 1
options OfficeIMO.Html.HtmlRenderOptions? = null optionalposition: 2
public static Void ExportImages(HtmlConversionDocument document, OfficeImageExportFormat format, OfficeImageExportConsumer consumer, HtmlRenderOptions? options = null, CancellationToken cancellationToken = default) #
Returns: Void

Streams rendered surfaces without retaining earlier encoded payloads.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
format OfficeIMO.Drawing.OfficeImageExportFormat requiredposition: 1
consumer OfficeIMO.Drawing.OfficeImageExportConsumer requiredposition: 2
options OfficeIMO.Html.HtmlRenderOptions? = null optionalposition: 3
cancellationToken System.Threading.CancellationToken = default optionalposition: 4
ExportImagesAsync 2 overloads
public static async Task<IReadOnlyList<OfficeImageExportResult>> ExportImagesAsync(HtmlConversionDocument document, OfficeImageExportFormat format, HtmlRenderOptions? options = null, CancellationToken cancellationToken = default) #
Returns: Task<IReadOnlyList<OfficeImageExportResult>>

Asynchronously renders all surfaces to the requested image format.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
format OfficeIMO.Drawing.OfficeImageExportFormat requiredposition: 1
options OfficeIMO.Html.HtmlRenderOptions? = null optionalposition: 2
cancellationToken System.Threading.CancellationToken = default optionalposition: 3
public static async Task ExportImagesAsync(HtmlConversionDocument document, OfficeImageExportFormat format, OfficeImageExportAsyncConsumer consumer, HtmlRenderOptions? options = null, CancellationToken cancellationToken = default) #
Returns: Task

Asynchronously streams rendered surfaces without retaining earlier encoded payloads.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
format OfficeIMO.Drawing.OfficeImageExportFormat requiredposition: 1
consumer OfficeIMO.Drawing.OfficeImageExportAsyncConsumer requiredposition: 2
options OfficeIMO.Html.HtmlRenderOptions? = null optionalposition: 3
cancellationToken System.Threading.CancellationToken = default optionalposition: 4
public static IReadOnlyList<OfficeImageExportResult> RenderImages(HtmlConversionDocument document, HtmlRenderRequest request, CancellationToken cancellationToken = default) #
Returns: IReadOnlyList<OfficeImageExportResult>

Executes an explicit request and encodes every retained image surface.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
request OfficeIMO.Html.HtmlRenderRequest requiredposition: 1
cancellationToken System.Threading.CancellationToken = default optionalposition: 2
public static async Task<IReadOnlyList<OfficeImageExportResult>> RenderImagesAsync(HtmlConversionDocument document, HtmlRenderRequest request, CancellationToken cancellationToken = default) #
Returns: Task<IReadOnlyList<OfficeImageExportResult>>

Executes an explicit request asynchronously and encodes every retained image surface.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
request OfficeIMO.Html.HtmlRenderRequest requiredposition: 1
cancellationToken System.Threading.CancellationToken = default optionalposition: 2
public static Byte[] RenderToPdfBytes(HtmlConversionDocument document, HtmlRenderRequest request, CancellationToken cancellationToken = default) #
Returns: Byte[]

Executes an explicit PDF render request and serializes the resulting document.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
request OfficeIMO.Html.HtmlRenderRequest requiredposition: 1
cancellationToken System.Threading.CancellationToken = default optionalposition: 2
public static async Task<Byte[]> RenderToPdfBytesAsync(HtmlConversionDocument document, HtmlRenderRequest request, CancellationToken cancellationToken = default) #
Returns: Task<Byte[]>

Executes an explicit PDF render request and asynchronously serializes the result.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
request OfficeIMO.Html.HtmlRenderRequest requiredposition: 1
cancellationToken System.Threading.CancellationToken = default optionalposition: 2
public static PdfDocumentConversionResult RenderToPdfDocumentResult(HtmlConversionDocument document, HtmlRenderRequest request, CancellationToken cancellationToken = default) #
Returns: PdfDocumentConversionResult

Executes an explicit PDF render request and returns the PDF plus its conversion report.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
request OfficeIMO.Html.HtmlRenderRequest requiredposition: 1
cancellationToken System.Threading.CancellationToken = default optionalposition: 2
public static async Task<PdfDocumentConversionResult> RenderToPdfDocumentResultAsync(HtmlConversionDocument document, HtmlRenderRequest request, CancellationToken cancellationToken = default) #
Returns: Task<PdfDocumentConversionResult>

Asynchronously executes an explicit PDF render request and returns the PDF plus its conversion report.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
request OfficeIMO.Html.HtmlRenderRequest requiredposition: 1
cancellationToken System.Threading.CancellationToken = default optionalposition: 2
public static HtmlPdfRenderRequestResult RenderToPdfResult(HtmlConversionDocument document, HtmlRenderRequest request, CancellationToken cancellationToken = default) #
Returns: HtmlPdfRenderRequestResult

Executes an explicit request and returns its retained surfaces together with the PDF output.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
request OfficeIMO.Html.HtmlRenderRequest requiredposition: 1
cancellationToken System.Threading.CancellationToken = default optionalposition: 2
public static async Task<HtmlPdfRenderRequestResult> RenderToPdfResultAsync(HtmlConversionDocument document, HtmlRenderRequest request, CancellationToken cancellationToken = default) #
Returns: Task<HtmlPdfRenderRequestResult>

Asynchronously executes an explicit request and returns its retained surfaces with the PDF output.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
request OfficeIMO.Html.HtmlRenderRequest requiredposition: 1
cancellationToken System.Threading.CancellationToken = default optionalposition: 2
SaveAsJpeg 2 overloads
public static OfficeImageExportResult SaveAsJpeg(HtmlConversionDocument document, String path, HtmlRenderOptions? options = null, Int32 pageIndex = 0) #
Returns: OfficeImageExportResult

Saves a shared HTML conversion document as a JPEG file.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
path System.String requiredposition: 1
options OfficeIMO.Html.HtmlRenderOptions? = null optionalposition: 2
pageIndex System.Int32 = 0 optionalposition: 3
public static OfficeImageExportResult SaveAsJpeg(HtmlConversionDocument document, Stream stream, HtmlRenderOptions? options = null, Int32 pageIndex = 0) #
Returns: OfficeImageExportResult

Writes a shared HTML conversion document as JPEG to a caller-owned stream.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
stream System.IO.Stream requiredposition: 1
options OfficeIMO.Html.HtmlRenderOptions? = null optionalposition: 2
pageIndex System.Int32 = 0 optionalposition: 3
SaveAsJpegAsync 2 overloads
public static Task<OfficeImageExportResult> SaveAsJpegAsync(HtmlConversionDocument document, String path, HtmlRenderOptions? options = null, Int32 pageIndex = 0, CancellationToken cancellationToken = default) #
Returns: Task<OfficeImageExportResult>

Asynchronously resolves resources and saves a shared HTML conversion document as a JPEG file.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
path System.String requiredposition: 1
options OfficeIMO.Html.HtmlRenderOptions? = null optionalposition: 2
pageIndex System.Int32 = 0 optionalposition: 3
cancellationToken System.Threading.CancellationToken = default optionalposition: 4
public static Task<OfficeImageExportResult> SaveAsJpegAsync(HtmlConversionDocument document, Stream stream, HtmlRenderOptions? options = null, Int32 pageIndex = 0, CancellationToken cancellationToken = default) #
Returns: Task<OfficeImageExportResult>

Asynchronously resolves resources and writes JPEG to a caller-owned stream.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
stream System.IO.Stream requiredposition: 1
options OfficeIMO.Html.HtmlRenderOptions? = null optionalposition: 2
pageIndex System.Int32 = 0 optionalposition: 3
cancellationToken System.Threading.CancellationToken = default optionalposition: 4
SaveAsPdf 2 overloads
public static PdfSaveResult SaveAsPdf(HtmlConversionDocument document, String path, HtmlToPdfOptions? options = null, CancellationToken cancellationToken = default) #
Returns: PdfSaveResult

Converts a parsed HTML document and saves it as a PDF file.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
path System.String requiredposition: 1
options OfficeIMO.Html.Pdf.HtmlToPdfOptions? = null optionalposition: 2
cancellationToken System.Threading.CancellationToken = default optionalposition: 3
public static PdfSaveResult SaveAsPdf(HtmlConversionDocument document, Stream pdfStream, HtmlToPdfOptions? options = null, CancellationToken cancellationToken = default) #
Returns: PdfSaveResult

Converts a parsed HTML document and writes it as PDF to a caller-owned stream.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
pdfStream System.IO.Stream requiredposition: 1
options OfficeIMO.Html.Pdf.HtmlToPdfOptions? = null optionalposition: 2
cancellationToken System.Threading.CancellationToken = default optionalposition: 3
SaveAsPdfAsync 2 overloads
public static async Task<PdfSaveResult> SaveAsPdfAsync(HtmlConversionDocument document, String path, HtmlToPdfOptions? options = null, CancellationToken cancellationToken = default) #
Returns: Task<PdfSaveResult>

Asynchronously converts a parsed HTML document and saves it as a PDF file.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
path System.String requiredposition: 1
options OfficeIMO.Html.Pdf.HtmlToPdfOptions? = null optionalposition: 2
cancellationToken System.Threading.CancellationToken = default optionalposition: 3
public static async Task<PdfSaveResult> SaveAsPdfAsync(HtmlConversionDocument document, Stream pdfStream, HtmlToPdfOptions? options = null, CancellationToken cancellationToken = default) #
Returns: Task<PdfSaveResult>

Asynchronously converts a parsed HTML document and writes it as PDF to a caller-owned stream.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
pdfStream System.IO.Stream requiredposition: 1
options OfficeIMO.Html.Pdf.HtmlToPdfOptions? = null optionalposition: 2
cancellationToken System.Threading.CancellationToken = default optionalposition: 3
SaveAsPdfResult 2 overloads
public static PdfSaveResult SaveAsPdfResult(HtmlConversionDocument document, String path, HtmlToPdfOptions? options = null, CancellationToken cancellationToken = default) #
Returns: PdfSaveResult

Attempts to convert a parsed HTML document and save it as a PDF file.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
path System.String requiredposition: 1
options OfficeIMO.Html.Pdf.HtmlToPdfOptions? = null optionalposition: 2
cancellationToken System.Threading.CancellationToken = default optionalposition: 3
public static PdfSaveResult SaveAsPdfResult(HtmlConversionDocument document, Stream pdfStream, HtmlToPdfOptions? options = null, CancellationToken cancellationToken = default) #
Returns: PdfSaveResult

Attempts to convert a parsed HTML document and write it as PDF to a caller-owned stream.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
pdfStream System.IO.Stream requiredposition: 1
options OfficeIMO.Html.Pdf.HtmlToPdfOptions? = null optionalposition: 2
cancellationToken System.Threading.CancellationToken = default optionalposition: 3
SaveAsPdfResultAsync 2 overloads
public static async Task<PdfSaveResult> SaveAsPdfResultAsync(HtmlConversionDocument document, String path, HtmlToPdfOptions? options = null, CancellationToken cancellationToken = default) #
Returns: Task<PdfSaveResult>

Asynchronously attempts to convert a parsed HTML document and save it as a PDF file.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
path System.String requiredposition: 1
options OfficeIMO.Html.Pdf.HtmlToPdfOptions? = null optionalposition: 2
cancellationToken System.Threading.CancellationToken = default optionalposition: 3
public static async Task<PdfSaveResult> SaveAsPdfResultAsync(HtmlConversionDocument document, Stream pdfStream, HtmlToPdfOptions? options = null, CancellationToken cancellationToken = default) #
Returns: Task<PdfSaveResult>

Asynchronously attempts to convert a parsed HTML document and write it as PDF to a caller-owned stream.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
pdfStream System.IO.Stream requiredposition: 1
options OfficeIMO.Html.Pdf.HtmlToPdfOptions? = null optionalposition: 2
cancellationToken System.Threading.CancellationToken = default optionalposition: 3
SaveAsPng 2 overloads
public static OfficeImageExportResult SaveAsPng(HtmlConversionDocument document, String path, HtmlRenderOptions? options = null, Int32 pageIndex = 0) #
Returns: OfficeImageExportResult

Saves a shared HTML conversion document as a PNG file.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
path System.String requiredposition: 1
options OfficeIMO.Html.HtmlRenderOptions? = null optionalposition: 2
pageIndex System.Int32 = 0 optionalposition: 3
public static OfficeImageExportResult SaveAsPng(HtmlConversionDocument document, Stream stream, HtmlRenderOptions? options = null, Int32 pageIndex = 0) #
Returns: OfficeImageExportResult

Writes a shared HTML conversion document as PNG to a caller-owned stream.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
stream System.IO.Stream requiredposition: 1
options OfficeIMO.Html.HtmlRenderOptions? = null optionalposition: 2
pageIndex System.Int32 = 0 optionalposition: 3
SaveAsPngAsync 2 overloads
public static Task<OfficeImageExportResult> SaveAsPngAsync(HtmlConversionDocument document, String path, HtmlRenderOptions? options = null, Int32 pageIndex = 0, CancellationToken cancellationToken = default) #
Returns: Task<OfficeImageExportResult>

Asynchronously resolves resources and saves a shared HTML conversion document as a PNG file.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
path System.String requiredposition: 1
options OfficeIMO.Html.HtmlRenderOptions? = null optionalposition: 2
pageIndex System.Int32 = 0 optionalposition: 3
cancellationToken System.Threading.CancellationToken = default optionalposition: 4
public static Task<OfficeImageExportResult> SaveAsPngAsync(HtmlConversionDocument document, Stream stream, HtmlRenderOptions? options = null, Int32 pageIndex = 0, CancellationToken cancellationToken = default) #
Returns: Task<OfficeImageExportResult>

Asynchronously resolves resources and writes PNG to a caller-owned stream.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
stream System.IO.Stream requiredposition: 1
options OfficeIMO.Html.HtmlRenderOptions? = null optionalposition: 2
pageIndex System.Int32 = 0 optionalposition: 3
cancellationToken System.Threading.CancellationToken = default optionalposition: 4
SaveAsSvg 2 overloads
public static OfficeImageExportResult SaveAsSvg(HtmlConversionDocument document, String path, HtmlRenderOptions? options = null, Int32 pageIndex = 0) #
Returns: OfficeImageExportResult

Saves a shared HTML conversion document as an SVG file.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
path System.String requiredposition: 1
options OfficeIMO.Html.HtmlRenderOptions? = null optionalposition: 2
pageIndex System.Int32 = 0 optionalposition: 3
public static OfficeImageExportResult SaveAsSvg(HtmlConversionDocument document, Stream stream, HtmlRenderOptions? options = null, Int32 pageIndex = 0) #
Returns: OfficeImageExportResult

Writes a shared HTML conversion document as SVG to a caller-owned stream.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
stream System.IO.Stream requiredposition: 1
options OfficeIMO.Html.HtmlRenderOptions? = null optionalposition: 2
pageIndex System.Int32 = 0 optionalposition: 3
SaveAsSvgAsync 2 overloads
public static Task<OfficeImageExportResult> SaveAsSvgAsync(HtmlConversionDocument document, String path, HtmlRenderOptions? options = null, Int32 pageIndex = 0, CancellationToken cancellationToken = default) #
Returns: Task<OfficeImageExportResult>

Asynchronously resolves resources and saves a shared HTML conversion document as an SVG file.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
path System.String requiredposition: 1
options OfficeIMO.Html.HtmlRenderOptions? = null optionalposition: 2
pageIndex System.Int32 = 0 optionalposition: 3
cancellationToken System.Threading.CancellationToken = default optionalposition: 4
public static Task<OfficeImageExportResult> SaveAsSvgAsync(HtmlConversionDocument document, Stream stream, HtmlRenderOptions? options = null, Int32 pageIndex = 0, CancellationToken cancellationToken = default) #
Returns: Task<OfficeImageExportResult>

Asynchronously resolves resources and writes SVG to a caller-owned stream.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
stream System.IO.Stream requiredposition: 1
options OfficeIMO.Html.HtmlRenderOptions? = null optionalposition: 2
pageIndex System.Int32 = 0 optionalposition: 3
cancellationToken System.Threading.CancellationToken = default optionalposition: 4
SaveAsTiff 2 overloads
public static OfficeImageExportResult SaveAsTiff(HtmlConversionDocument document, String path, HtmlRenderOptions? options = null, Int32 pageIndex = 0) #
Returns: OfficeImageExportResult

Saves a shared HTML conversion document as a TIFF file.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
path System.String requiredposition: 1
options OfficeIMO.Html.HtmlRenderOptions? = null optionalposition: 2
pageIndex System.Int32 = 0 optionalposition: 3
public static OfficeImageExportResult SaveAsTiff(HtmlConversionDocument document, Stream stream, HtmlRenderOptions? options = null, Int32 pageIndex = 0) #
Returns: OfficeImageExportResult

Writes a shared HTML conversion document as TIFF to a caller-owned stream.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
stream System.IO.Stream requiredposition: 1
options OfficeIMO.Html.HtmlRenderOptions? = null optionalposition: 2
pageIndex System.Int32 = 0 optionalposition: 3
SaveAsTiffAsync 2 overloads
public static Task<OfficeImageExportResult> SaveAsTiffAsync(HtmlConversionDocument document, String path, HtmlRenderOptions? options = null, Int32 pageIndex = 0, CancellationToken cancellationToken = default) #
Returns: Task<OfficeImageExportResult>

Asynchronously resolves resources and saves a shared HTML conversion document as a TIFF file.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
path System.String requiredposition: 1
options OfficeIMO.Html.HtmlRenderOptions? = null optionalposition: 2
pageIndex System.Int32 = 0 optionalposition: 3
cancellationToken System.Threading.CancellationToken = default optionalposition: 4
public static Task<OfficeImageExportResult> SaveAsTiffAsync(HtmlConversionDocument document, Stream stream, HtmlRenderOptions? options = null, Int32 pageIndex = 0, CancellationToken cancellationToken = default) #
Returns: Task<OfficeImageExportResult>

Asynchronously resolves resources and writes TIFF to a caller-owned stream.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
stream System.IO.Stream requiredposition: 1
options OfficeIMO.Html.HtmlRenderOptions? = null optionalposition: 2
pageIndex System.Int32 = 0 optionalposition: 3
cancellationToken System.Threading.CancellationToken = default optionalposition: 4
SaveAsWebp 2 overloads
public static OfficeImageExportResult SaveAsWebp(HtmlConversionDocument document, String path, HtmlRenderOptions? options = null, Int32 pageIndex = 0) #
Returns: OfficeImageExportResult

Saves a shared HTML conversion document as a lossless WebP file.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
path System.String requiredposition: 1
options OfficeIMO.Html.HtmlRenderOptions? = null optionalposition: 2
pageIndex System.Int32 = 0 optionalposition: 3
public static OfficeImageExportResult SaveAsWebp(HtmlConversionDocument document, Stream stream, HtmlRenderOptions? options = null, Int32 pageIndex = 0) #
Returns: OfficeImageExportResult

Writes a shared HTML conversion document as lossless WebP to a caller-owned stream.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
stream System.IO.Stream requiredposition: 1
options OfficeIMO.Html.HtmlRenderOptions? = null optionalposition: 2
pageIndex System.Int32 = 0 optionalposition: 3
SaveAsWebpAsync 2 overloads
public static Task<OfficeImageExportResult> SaveAsWebpAsync(HtmlConversionDocument document, String path, HtmlRenderOptions? options = null, Int32 pageIndex = 0, CancellationToken cancellationToken = default) #
Returns: Task<OfficeImageExportResult>

Asynchronously resolves resources and saves a shared HTML conversion document as a lossless WebP file.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
path System.String requiredposition: 1
options OfficeIMO.Html.HtmlRenderOptions? = null optionalposition: 2
pageIndex System.Int32 = 0 optionalposition: 3
cancellationToken System.Threading.CancellationToken = default optionalposition: 4
public static Task<OfficeImageExportResult> SaveAsWebpAsync(HtmlConversionDocument document, Stream stream, HtmlRenderOptions? options = null, Int32 pageIndex = 0, CancellationToken cancellationToken = default) #
Returns: Task<OfficeImageExportResult>

Asynchronously resolves resources and writes lossless WebP to a caller-owned stream.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
stream System.IO.Stream requiredposition: 1
options OfficeIMO.Html.HtmlRenderOptions? = null optionalposition: 2
pageIndex System.Int32 = 0 optionalposition: 3
cancellationToken System.Threading.CancellationToken = default optionalposition: 4
SaveRenderCapabilityGallery 2 overloads
public static HtmlCapabilityGalleryManifest SaveRenderCapabilityGallery(HtmlConversionDocument document, String directoryPath, HtmlRenderCapabilityGalleryOptions options) #
Returns: HtmlCapabilityGalleryManifest

Writes the exact HTML input, paged PDF, selected or all-page previews, and manifests with artifact-specific evidence.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
directoryPath System.String requiredposition: 1
options OfficeIMO.Html.Pdf.HtmlRenderCapabilityGalleryOptions requiredposition: 2
public static HtmlCapabilityGalleryManifest SaveRenderCapabilityGallery(HtmlConversionDocument document, String directoryPath, HtmlRenderCapabilityGalleryOptions options, CancellationToken cancellationToken) #
Returns: HtmlCapabilityGalleryManifest

Writes a gallery while observing cancellation and the shared rendering deadline and preview budgets.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
directoryPath System.String requiredposition: 1
options OfficeIMO.Html.Pdf.HtmlRenderCapabilityGalleryOptions requiredposition: 2
cancellationToken System.Threading.CancellationToken requiredposition: 3
ToImage 2 overloads
public static HtmlPageImageExportBuilder ToImage(HtmlConversionDocument document) #
Returns: HtmlPageImageExportBuilder

Starts fluent image export for one rendered HTML surface.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
public static HtmlPageImageExportBuilder ToImage(HtmlConversionDocument document, HtmlRenderOptions options) #
Returns: HtmlPageImageExportBuilder

Starts fluent image export for one rendered HTML surface using a cloned options snapshot.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
options OfficeIMO.Html.HtmlRenderOptions requiredposition: 1
ToImages 2 overloads
public static HtmlPageImageBatchExportBuilder ToImages(HtmlConversionDocument document) #
Returns: HtmlPageImageBatchExportBuilder

Starts fluent image export for all rendered HTML pages.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
public static HtmlPageImageBatchExportBuilder ToImages(HtmlConversionDocument document, HtmlRenderOptions options) #
Returns: HtmlPageImageBatchExportBuilder

Starts fluent image export for all rendered HTML pages using a cloned options snapshot.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
options OfficeIMO.Html.HtmlRenderOptions requiredposition: 1
public static Byte[] ToJpeg(HtmlConversionDocument document, HtmlRenderOptions? options = null, Int32 pageIndex = 0) #
Returns: Byte[]

Renders a shared HTML conversion document to JPEG bytes.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
options OfficeIMO.Html.HtmlRenderOptions? = null optionalposition: 1
pageIndex System.Int32 = 0 optionalposition: 2
public static async Task<Byte[]> ToJpegAsync(HtmlConversionDocument document, HtmlRenderOptions? options = null, Int32 pageIndex = 0, CancellationToken cancellationToken = default) #
Returns: Task<Byte[]>

Asynchronously resolves resources and renders a shared HTML conversion document to JPEG bytes.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
options OfficeIMO.Html.HtmlRenderOptions? = null optionalposition: 1
pageIndex System.Int32 = 0 optionalposition: 2
cancellationToken System.Threading.CancellationToken = default optionalposition: 3
public static Byte[] ToPdfBytes(HtmlConversionDocument document, HtmlToPdfOptions? options = null, CancellationToken cancellationToken = default) #
Returns: Byte[]

Converts a parsed HTML document to PDF bytes.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
options OfficeIMO.Html.Pdf.HtmlToPdfOptions? = null optionalposition: 1
cancellationToken System.Threading.CancellationToken = default optionalposition: 2
public static async Task<Byte[]> ToPdfBytesAsync(HtmlConversionDocument document, HtmlToPdfOptions? options = null, CancellationToken cancellationToken = default) #
Returns: Task<Byte[]>

Asynchronously resolves HTML resources and converts a parsed HTML document to PDF bytes.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
options OfficeIMO.Html.Pdf.HtmlToPdfOptions? = null optionalposition: 1
cancellationToken System.Threading.CancellationToken = default optionalposition: 2
public static PdfDocument ToPdfDocument(HtmlConversionDocument document, HtmlToPdfOptions? options = null, CancellationToken cancellationToken = default) #
Returns: PdfDocument

Converts a parsed HTML document to the first-party PDF document model.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
options OfficeIMO.Html.Pdf.HtmlToPdfOptions? = null optionalposition: 1
cancellationToken System.Threading.CancellationToken = default optionalposition: 2
public static async Task<PdfDocument> ToPdfDocumentAsync(HtmlConversionDocument document, HtmlToPdfOptions? options = null, CancellationToken cancellationToken = default) #
Returns: Task<PdfDocument>

Asynchronously converts a parsed HTML document to the first-party PDF document model.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
options OfficeIMO.Html.Pdf.HtmlToPdfOptions? = null optionalposition: 1
cancellationToken System.Threading.CancellationToken = default optionalposition: 2
public static PdfDocumentConversionResult ToPdfDocumentResult(HtmlConversionDocument document, HtmlToPdfOptions? options = null, CancellationToken cancellationToken = default) #
Returns: PdfDocumentConversionResult

Converts a parsed HTML document to PDF plus an immutable diagnostics snapshot.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
options OfficeIMO.Html.Pdf.HtmlToPdfOptions? = null optionalposition: 1
cancellationToken System.Threading.CancellationToken = default optionalposition: 2
public static async Task<PdfDocumentConversionResult> ToPdfDocumentResultAsync(HtmlConversionDocument document, HtmlToPdfOptions? options = null, CancellationToken cancellationToken = default) #
Returns: Task<PdfDocumentConversionResult>

Asynchronously converts a parsed HTML document to PDF plus an immutable diagnostics snapshot.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
options OfficeIMO.Html.Pdf.HtmlToPdfOptions? = null optionalposition: 1
cancellationToken System.Threading.CancellationToken = default optionalposition: 2
public static Byte[] ToPng(HtmlConversionDocument document, HtmlRenderOptions? options = null, Int32 pageIndex = 0) #
Returns: Byte[]

Renders a shared HTML conversion document to PNG bytes.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
options OfficeIMO.Html.HtmlRenderOptions? = null optionalposition: 1
pageIndex System.Int32 = 0 optionalposition: 2
public static async Task<Byte[]> ToPngAsync(HtmlConversionDocument document, HtmlRenderOptions? options = null, Int32 pageIndex = 0, CancellationToken cancellationToken = default) #
Returns: Task<Byte[]>

Asynchronously resolves resources and renders a shared HTML conversion document to PNG bytes.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
options OfficeIMO.Html.HtmlRenderOptions? = null optionalposition: 1
pageIndex System.Int32 = 0 optionalposition: 2
cancellationToken System.Threading.CancellationToken = default optionalposition: 3
public static String ToSvg(HtmlConversionDocument document, HtmlRenderOptions? options = null, Int32 pageIndex = 0) #
Returns: String

Renders a shared HTML conversion document to SVG text.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
options OfficeIMO.Html.HtmlRenderOptions? = null optionalposition: 1
pageIndex System.Int32 = 0 optionalposition: 2
public static async Task<String> ToSvgAsync(HtmlConversionDocument document, HtmlRenderOptions? options = null, Int32 pageIndex = 0, CancellationToken cancellationToken = default) #
Returns: Task<String>

Asynchronously resolves resources and renders a shared HTML conversion document to SVG text.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
options OfficeIMO.Html.HtmlRenderOptions? = null optionalposition: 1
pageIndex System.Int32 = 0 optionalposition: 2
cancellationToken System.Threading.CancellationToken = default optionalposition: 3
public static Byte[] ToTiff(HtmlConversionDocument document, HtmlRenderOptions? options = null, Int32 pageIndex = 0) #
Returns: Byte[]

Renders a shared HTML conversion document to TIFF bytes.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
options OfficeIMO.Html.HtmlRenderOptions? = null optionalposition: 1
pageIndex System.Int32 = 0 optionalposition: 2
public static async Task<Byte[]> ToTiffAsync(HtmlConversionDocument document, HtmlRenderOptions? options = null, Int32 pageIndex = 0, CancellationToken cancellationToken = default) #
Returns: Task<Byte[]>

Asynchronously resolves resources and renders a shared HTML conversion document to TIFF bytes.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
options OfficeIMO.Html.HtmlRenderOptions? = null optionalposition: 1
pageIndex System.Int32 = 0 optionalposition: 2
cancellationToken System.Threading.CancellationToken = default optionalposition: 3
public static Byte[] ToWebp(HtmlConversionDocument document, HtmlRenderOptions? options = null, Int32 pageIndex = 0) #
Returns: Byte[]

Renders a shared HTML conversion document to lossless WebP bytes.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
options OfficeIMO.Html.HtmlRenderOptions? = null optionalposition: 1
pageIndex System.Int32 = 0 optionalposition: 2
public static async Task<Byte[]> ToWebpAsync(HtmlConversionDocument document, HtmlRenderOptions? options = null, Int32 pageIndex = 0, CancellationToken cancellationToken = default) #
Returns: Task<Byte[]>

Asynchronously resolves resources and renders a shared HTML conversion document to lossless WebP bytes.

Parameters

document OfficeIMO.Html.HtmlConversionDocument requiredposition: 0
options OfficeIMO.Html.HtmlRenderOptions? = null optionalposition: 1
pageIndex System.Int32 = 0 optionalposition: 2
cancellationToken System.Threading.CancellationToken = default optionalposition: 3