API Reference
OfficeDocumentReadResult
Shared result envelope for document readback workflows.
Inheritance
- Object
- OfficeDocumentReadResult
Usage
This type appears in these public API surfaces even when no hand-authored example is attached directly to the page.
Returned or exposed by
- Method DocumentReader.ReadDocument
- Method DocumentReader.ReadDocument
Accepted by parameters
- Method DocumentReader.ExtractAssets
- Method OfficeDocumentAssetDataUri.BuildAssetDataUriMap
- Method OfficeDocumentAssetMaterializer.StreamAssets
- Method OfficeDocumentAssetMaterializer.WriteAssetsToDirectory
- Extension method OfficeDocumentReadResult.BuildAssetDataUriMap
- Extension method OfficeDocumentReadResult.StreamAssets
- Extension method OfficeDocumentReadResult.ToJson
- Extension method OfficeDocumentReadResult.WriteAssetsToDirectory
- Method OfficeDocumentReadResultJson.Serialize
- Method OfficeDocumentReadResultJson.ToJson
Constructors
public OfficeDocumentReadResult() #Inherited Methods
Properties
public String SchemaId { get; set; } #Result schema identifier.
public Int32 SchemaVersion { get; set; } #Result schema version.
public ReaderInputKind Kind { get; set; } #Source input kind that produced this result.
public OfficeDocumentSource Source { get; set; } #Source document metadata used for citations and incremental processing.
public IReadOnlyList<String> CapabilitiesUsed { get; set; } #Capability identifiers used while producing this result.
public String Markdown { get; set; } #Portable Markdown representation when available.
public String Html { get; set; } #Portable or review HTML representation when available.
public String Json { get; set; } #Deterministic JSON representation when a producer emits one.
public IReadOnlyList<ReaderChunk> Chunks { get; set; } #Reader chunks produced by the same extraction run.
public IReadOnlyList<OfficeDocumentMetadataEntry> Metadata { get; set; } #Document-level metadata entries discovered during reading.
public IReadOnlyList<OfficeDocumentPage> Pages { get; set; } #Page, slide, sheet, or diagram-page records produced by document reading.
public IReadOnlyList<OfficeDocumentBlock> Blocks { get; set; } #Normalized logical blocks in source order.
public IReadOnlyList<ReaderTable> Tables { get; set; } #Structured tables extracted or detected during reading.
public IReadOnlyList<OfficeDocumentAsset> Assets { get; set; } #Images, previews, and other binary or visual assets discovered during reading.
public IReadOnlyList<OfficeDocumentLink> Links { get; set; } #Hyperlinks, internal destinations, and navigation targets discovered during reading.
public IReadOnlyList<OfficeDocumentFormField> Forms { get; set; } #Form fields or widgets discovered during reading.
public IReadOnlyList<OfficeDocumentOcrCandidate> OcrCandidates { get; set; } #Regions that likely need OCR before text extraction can be considered complete.
public IReadOnlyList<ReaderVisual> Visuals { get; set; } #Structured visual payloads discovered during reading.
public IReadOnlyList<OfficeDocumentDiagnostic> Diagnostics { get; set; } #Warnings and diagnostics emitted during reading.
Extension Methods
public static IReadOnlyDictionary<String, String> BuildAssetDataUriMap(OfficeDocumentReadResult result, OfficeDocumentAssetDataUriOptions options = null) #IReadOnlyDictionary<String, String>Builds a data URI map keyed by asset id for materializable assets in a read result.
Parameters
- result OfficeIMO.Reader.OfficeDocumentReadResult
- Read result that owns the assets.
- options OfficeIMO.Reader.OfficeDocumentAssetDataUriOptions = null
- Data URI options.
public static IReadOnlyList<OfficeDocumentMaterializedAsset> StreamAssets(OfficeDocumentReadResult result, Action<OfficeDocumentAsset, Stream> writeAsset, OfficeDocumentAssetMaterializationOptions options = null, CancellationToken cancellationToken = null) #IReadOnlyList<OfficeDocumentMaterializedAsset>Streams materializable asset payloads to a caller-owned callback without writing files.
Parameters
- result OfficeIMO.Reader.OfficeDocumentReadResult
- Read result that owns the assets.
- writeAsset System.Action{OfficeIMO.Reader.OfficeDocumentAsset,System.IO.Stream}
- Callback that receives each asset and a readable payload stream.
- options OfficeIMO.Reader.OfficeDocumentAssetMaterializationOptions = null
- Materialization options.
- cancellationToken System.Threading.CancellationToken = null
- Cancellation token.
public static String ToJson(OfficeDocumentReadResult result, Boolean indented = false) #StringSerializes a document read result into the stable OfficeIMO transport shape.
Parameters
- result OfficeIMO.Reader.OfficeDocumentReadResult
- Read result to serialize.
- indented System.Boolean = false
- When true, writes indented JSON for diagnostics and fixtures.
public static IReadOnlyList<OfficeDocumentMaterializedAsset> WriteAssetsToDirectory(OfficeDocumentReadResult result, String directoryPath, OfficeDocumentAssetMaterializationOptions options = null, CancellationToken cancellationToken = null) #IReadOnlyList<OfficeDocumentMaterializedAsset>Writes materializable asset payloads to directoryPath using each asset's deterministic filename.
Parameters
- result OfficeIMO.Reader.OfficeDocumentReadResult
- Read result that owns the assets.
- directoryPath System.String
- Destination directory.
- options OfficeIMO.Reader.OfficeDocumentAssetMaterializationOptions = null
- Materialization options.
- cancellationToken System.Threading.CancellationToken = null
- Cancellation token.