OfficeIMO.Reader.Visio 3.6.1

OfficeIMO.Reader.Visio - Visio reader adapter

OfficeIMO.Reader.Visio provides a Visio adapter for OfficeIMO.Reader.Core using OfficeIMO.Visio inspection snapshots.

Install

dotnet add package OfficeIMO.Reader.Visio

Register

using OfficeIMO.Reader;
using OfficeIMO.Reader.Visio;

OfficeDocumentReader reader = new OfficeDocumentReaderBuilder()
    .AddVisioHandler()
    .Build();

IReadOnlyList<ReaderChunk> chunks = reader
    .Read("diagram.vsdx")
    .ToList();

The handler also dispatches .vdx, .vsx, and .vtx through the legacy XML import profile. It also imports .vsd, .vss and .vst through the bounded binary version 11 profile, with import losses included in results. Give streams their real filename extension so the adapter selects the correct family. Import diagnostics appear in document results and chunk warnings. Page-less stencils have no page text chunks; use the Visio master model for their reusable shapes.

Examples

Inspect pages, shapes, and Shape Data

using OfficeIMO.Reader;
using OfficeIMO.Reader.Visio;

OfficeDocumentReader reader = new OfficeDocumentReaderBuilder()
    .AddVisioHandler()
    .Build();

foreach (var chunk in reader.Enumerate("architecture.vsdx")) {
    Console.WriteLine($"Page {chunk.Location.Page}: {chunk.Id}");
    Console.WriteLine(chunk.Markdown ?? chunk.Text);

    foreach (var table in chunk.Tables ?? Array.Empty<ReaderTable>()) {
        Console.WriteLine($"Shape Data table: {table.Rows.Count} row(s)");
    }
}

Read Visio files from a folder with other formats

using OfficeIMO.Reader;
using OfficeIMO.Reader.Pdf;
using OfficeIMO.Reader.Visio;

OfficeDocumentReader reader = new OfficeDocumentReaderBuilder()
    .AddPdfHandler()
    .AddVisioHandler()
    .Build();

var chunks = reader.EnumerateFolder("Architecture",
    new ReaderFolderOptions {
        Extensions = new[] { ".vsdx", ".pdf" },
        Recurse = true,
        DeterministicOrder = true
    },
    new ReaderOptions {
        MaxChars = 8_000
    }).ToList();

Read topology and geometry

OfficeDocumentReader reader = new OfficeDocumentReaderBuilder()
    .AddVisioHandler()
    .Build();
OfficeDocumentReadResult document = reader.ReadDocument("network.vsdx");

foreach (ReaderVisual topology in document.Visuals) {
    Console.WriteLine($"Page {topology.Location.Page}: {topology.Content}");
}

foreach (OfficeDocumentPage page in document.Pages) {
    Console.WriteLine($"{page.Name}: {page.Width} x {page.Height} points");
}

The topology visual is deterministic JSON describing page shapes and connector edges. Shared regions and page dimensions are expressed in points. A configured reader uses the same native mapping through reader.ReadDocument("network.vsdx").

An already loaded VisioDocument can use the same projection without being serialized and reopened:

OfficeDocumentReadResult document = diagram.ToOfficeDocumentReadResult();

What it emits

• Page-aware chunks for .vsdx, .vstx, .vssx, .vsdm, .vstm, and .vssm files.
• Shape Data as ReaderTable rows.
• Pages, shapes, connectors, hyperlinks, and optional preview asset metadata in the shared read result envelope.
• Point-based geometry and one topology ReaderVisual per page for graph-aware consumers.
• Page-less stencils load as valid packages; they may produce no page chunks while their masters remain available through OfficeIMO.Visio.

Boundaries

• Reader adapter configuration belongs here.
• Visio package parsing and inspection belongs in OfficeIMO.Visio.
• Shared extraction contracts belong in OfficeIMO.Reader.Core.
• The handler advertises the same 512 MiB default input limit enforced by VisioDocument.Load; set ReaderOptions.MaxInputBytes explicitly to choose a different bound.

Targets and license

• Targets: netstandard2.0, net8.0, net10.0.
• License: MIT.

Dependency footprint

• External: System.IO.Packaging only through OfficeIMO.Visio.
• OfficeIMO: OfficeIMO.Reader.Core and OfficeIMO.Visio own diagram inspection, topology, chunks, tables, and visuals.

See the complete OfficeIMO package map for related formats and conversion paths.