Aspose.Diagram 24.12.0

.NET API for Microsoft Visio® File Formats

Aspose.Diagram for .NET is a powerful API for managing Microsoft Visio® diagrams in .NET applications. It supports creating, editing, converting, and protecting Visio® files, while maintaining full compatibility with all Visio® objects and properties, including shapes, pages, text, images, layers, and more. The API also enables applying protection to diagrams, converting diagrams to multiple formats (PDF, HTML, images), embedding VBA projects, and linking external data sources. Aspose.Diagram simplifies diagram manipulation for developers by providing comprehensive support for Visio® files across different platforms and environments.

Basic Operations

Create Visio Document

Create Visio diagrams programmatically using .NET APIs.

Open Visio Document

Open existing Visio documents in .NET applications.

Save Visio Document

Save Visio diagrams in different supported formats programmatically.

Diagram Conversion

Convert Visio to Excel

Export Visio diagrams to Excel (CSV format) for data analysis.

Convert Visio to PDF

Convert Visio diagrams to PDF format, including multipage PDFs with customizable options.

Convert Visio to Images

Convert Visio diagrams to image formats like PNG, JPEG, BMP, and TIFF.

Convert Visio to HTML

Convert Visio diagrams to HTML for easy web sharing and access.

Convert Visio to Other Formats

Export Visio diagrams to various formats including XML, XPS, SVG, SWF, and XAML.

Diagram Management

Working with Diagrams

Manage and manipulate entire Visio diagrams using the Aspose.Diagram API.

Working with Pages

Manage pages within Visio documents, including adding, reordering, and deleting pages.

Working with Layers

Control visibility, protection, and order of layers in Visio diagrams.

Document Properties

Access and modify metadata such as author, title, and subject in Visio documents.

SolutionXML Elements

Work with SolutionXML to store and manage custom data in Visio diagrams.

External Data Sources

Link external data sources to Visio diagrams for dynamic visualization.

VBA Project Integration

Embed and manipulate VBA projects in Visio diagrams using the .NET API.

Themes

Apply built-in themes to Visio diagrams for consistent visual styling.

Shapes and Drawing

Working with Shapes

Add, modify, and manipulate shapes within Visio diagrams programmatically.

Drawing

Use drawing tools to create and manipulate shapes and connectors in Visio files.

Geometry Section

Edit the geometry section of Visio shapes for precise positioning and layout.

Working with Masters

Manipulate master shapes to reuse components effectively.

Working with Layers

Control visibility, protection, and order of layers in Visio diagrams.

Text and Fonts

Working with Text

Manage and format text elements within Visio shapes.

Font Operations

Manage and manipulate fonts within Visio diagrams for better text presentation.

Text Boxes

Insert and edit text boxes in Visio diagrams to provide additional information.

Printing and Export

Print Settings

Configure printing settings for diagrams, including page setup and scaling options.

Working with Print

Print Visio diagrams with customizable options directly from .NET applications.

Diagram Conversions

Convert diagrams between multiple formats such as PDF, HTML, SVG, and others.

Advanced Features

Working with Fields

Edit and manage fields within Visio documents.

Working with Window Elements

Control the display and configuration of window elements within Visio diagrams.

User-defined Cells

Create and manage custom properties (user-defined cells) within Visio shapes.

Working with Hyperlinks

Add, update, and remove hyperlinks from Visio shapes and diagrams.

Working with Comments

Add, read, and manage comments within Visio diagrams for better collaboration.

Events Section

Use the Events section in the ShapeSheet to control behavior and automation.

OLE and ActiveX

OLE Objects

Insert and manipulate OLE objects within Visio diagrams.

ActiveX Controls

Embed and manage ActiveX controls in Visio diagrams for enhanced interactivity.

Visual Enhancements

Gradient Features

Apply and customize gradient fills, stops, and other gradient-related settings.

Working with Images

Embed, edit, and manipulate images within Visio diagrams.

Supported File Formats

Supported Operating Systems

Windows

2000, XP, Vista, 7, 8/8.1, 10, 2003-2019 Server (x64, x86)

macOS

Mac OS X x64 (10.12+)

Linux

Linux x64 (6, 7, 8.7+, 9, 14.04, 16.04, 18.04, 27, 42.3+, 12 SP2+)

Supported Development Environments

Microsoft Visual Studio

2003-2019

Supported .NET Framework Versions

.NET Framework

2.0 - 4.7.2, 4.0_ClientProfile

.NET Standard

2.0 (compatible with .NET Core 2.0/2.1)

Installation Steps for Aspose.Diagram for .NET

1. Install via NuGet

• Open Visual Studio.
• Go to Tools > Library Package Manager > Package Manager Console.
• Type: Install-Package Aspose.Diagram and press Enter.

2. Update via Package Manager Console

• Open Package Manager Console in Visual Studio.
• Type: Update-Package Aspose.Diagram to get the latest version.

3. Install via GUI

• Right-click your project in Solution Explorer.
• Select Manage NuGet Packages, search for Aspose.Diagram, and click Install.

Load a VSS Template to Create a Visio® Diagram with C# Code

You can execute the below code snippet to see how Aspose.Diagram API performs in your own environment or check the GitHub Repository for other common usage scenarios.

// create a new diagram
var diagram = new Diagram(dataDir + "template.vss");
// add a new rectangle shape
long shapeId = diagram.AddShape(4.25, 5.5, 2, 1, @ "Rectangle", 0);
var shape = diagram.Pages[0].Shapes.GetShape(shapeId);
shape.Text.Value.Add(new Txt(@ "Rectangle text."));
// add a new hexagon shape
shapeId = diagram.AddShape(7.0, 5.5, 2, 2, @ "Hexagon", 0);
shape = diagram.Pages[0].Shapes.GetShape(shapeId);
shape.Text.Value.Add(new Txt(@ "Hexagon text."));
// save the diagram in VDX format
diagram.Save(dir + "output.vdx", SaveFileFormat.VDX);

Retrieve Layers of a Visio® VSDX Diagram

Aspose.Diagram for .NET allows .NET applications to work with layers of Visio® drawings. The following C# code example shows how to fetch all the layers of a VSDX file:

// load source Visio® diagram
var diagram = new Diagram(dataDir + "Drawing1.vsdx");
// get diagram page
var page = diagram.Pages.GetPage("Page-1");
// iterate through the layers and print properties
foreach(Layer layer in page.PageSheet.Layers) {
  Console.WriteLine("Name: " + layer.Name.Value);
  Console.WriteLine("Visibility: " + layer.Visible.Value);
  Console.WriteLine("Status: " + layer.Status.Value);
}

.NET API | Microsoft Visio | Visio File Manipulation | Diagram Conversion | Visio Diagram Management | Shapes and Drawing | Text Management | VBA Project Integration | Themes | OLE and ActiveX | Gradient Features | External Data Sources | Visio File Formats | Print and Export | SolutionXML | User-defined Cells | Diagram API | NuGet Package | Windows, macOS, Linux | .NET Framework | .NET Standard | Visual Studio | Installation | NuGet Installation | Visio Layers | Hyperlinks | Comments | Events