How to Use DiagramConverter for .NET

The DiagramConverter class in Aspose.Diagram.LowCode namespace provides a simplified API for converting Visio diagram files between formats in .NET applications. It accepts all major Visio input formats and produces Visio output — for PDF output, use PdfConverter.

Key Features

  1. Format-agnostic conversion — Convert between VSDX, VSD, VDX, VSSX, VSTX, VSDM, and other Visio formats. The output format is determined by the destination file extension.
  2. Minimal code — A single static method call (DiagramConverter.Process()) handles the conversion with no boilerplate.
  3. File-path and stream-based API — Pass file paths directly or use LowCodeLoadOptions/LowCodeSaveOptions for stream-based, in-memory processing.
  4. Batch processing support — Loop over file collections and call Process() for each; the API is stateless and thread-safe per call.
  5. License and metered key support — Works with both file-based Aspose licenses and metered (pay-per-use) API keys.
  6. No external dependencies — Conversion runs entirely in-process; no Visio installation required on the server.

Use Cases

  • Format migration — Upgrade legacy VSD files to modern VSDX for better compatibility with current Visio versions.
  • CI/CD pipelines — Automate diagram format normalization as part of a build or release pipeline.
  • Document management systems — Accept any supported Visio upload and normalize to a standard format before storage.
  • Web APIs — Accept Visio file uploads via HTTP and return converted files using stream-based processing without temporary file writes.
  • Template generation — Convert VSTX template files to VSDX for programmatic editing downstream.
  • Archive normalization — Bulk-convert a library of historical diagrams to a single target format.

Getting Started

Step 1 — Install Aspose.Diagram via NuGet:

dotnet add package Aspose.Diagram

Step 2 — Apply your metered license:

using Aspose.Diagram;

Metered metered = new Metered();
metered.SetMeteredKey("publicKey", "privateKey");

Step 3 — Convert a Visio file:

using Aspose.Diagram.LowCode;

DiagramConverter.Process("input.vsdx", "output.vdx");

Step 4 — Explore advanced options and articles below.

Articles

DiagramConverter Basic Conversion Guide DiagramConverter Error Handling Guide DiagramConverter ASP.NET Core Integration Guide DiagramConverter Metered Licensing Guide

Prerequisites

  • Aspose.Diagram for .NET (version 26.4.0 or later)
  • Valid Aspose license or metered API key

Basic Usage 

using Aspose.Diagram.LowCode;

// Convert a Visio VSDX file to VDX format
DiagramConverter.Process("input.vsdx", "output.vdx");

Advanced Usage with Options 

using Aspose.Diagram.LowCode;

var loadOptions = new LowCodeLoadOptions();
loadOptions.InputFile = "input.vsdx";

var saveOptions = new LowCodeSaveOptions();
saveOptions.OutputFile = "output.vdx";

DiagramConverter.Process(loadOptions, saveOptions);

See Also