Universal.Operative.Sdk.Vsdx 2.2.1

There is a newer version of this package available.
See the version list below for details.
dotnet add package Universal.Operative.Sdk.Vsdx --version 2.2.1
                    
NuGet\Install-Package Universal.Operative.Sdk.Vsdx -Version 2.2.1
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Universal.Operative.Sdk.Vsdx" Version="2.2.1" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Universal.Operative.Sdk.Vsdx" Version="2.2.1" />
                    
Directory.Packages.props
<PackageReference Include="Universal.Operative.Sdk.Vsdx" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Universal.Operative.Sdk.Vsdx --version 2.2.1
                    
#r "nuget: Universal.Operative.Sdk.Vsdx, 2.2.1"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Universal.Operative.Sdk.Vsdx@2.2.1
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Universal.Operative.Sdk.Vsdx&version=2.2.1
                    
Install as a Cake Addin
#tool nuget:?package=Universal.Operative.Sdk.Vsdx&version=2.2.1
                    
Install as a Cake Tool

Universal.Operative.Sdk.Vsdx

Provides VSDX authoring, inspection, validation, and rendering tools.

Quick start

using Universal.Operative.Sdk.Vsdx.Tools;

builder.AddTools(VsdxToolSet.CreateDefault());

Focused tools and strict arguments

builder.AddTools(VsdxToolSet.CreateExpanded());

CreateDefault() retains the current editor and registration. CreateExpanded() provides 72 strict tools: eight help/inspection/validation/creation/render/export/stencil tools, 50 focused mutations, and 14 homogeneous batches. Choose one registration because shared names overlap. Both registrations accept stencilDirectories, fontResolver, and stencilBundles. Register individual focused tools or filter the expanded set when a task needs a smaller catalogue.

Every advertised argument is required, recursively; send null only where permitted. Null preserves a nullable patch property. False, zero, empty arrays and enum none are explicit values. All mutations write atomically; a failed batch leaves its destination unchanged. Keep the source .vsdx/.vsdm extension when editing; changing a name does not convert the package. Blank creation uses .vsdx.

Use explicit page_id (ID string or page name) and numeric shape_id from inspection/creation. IDs belong to a page. Coordinates/dimensions use inches from page top-left; font and outline widths use points. Rotation is clockwise. VsdxInspect labels grouped children with parent_shape_id and coordinate_space=parent_top_left; their bounds use parent coordinates and are cached, unrotated boxes.

VsdxReplaceText replaces a phrase with an exact expected count while retaining character-run markers and styles. VsdxSetText retains single-paragraph run markers. Preserving edits reject fields, paragraph/tab structures and inherited master text they cannot safely handle. VsdxReplaceTextContent and VsdxClearText explicitly discard inline structures. Text, font, alignment, margins, fill, line and arrows have independent tools. Font patches retain mixed properties and unrelated style bits; false disables only its requested flag. Arrow none, size zero, and left/top alignment explicitly reset those properties.

Creation includes native rectangles, ellipses, decision diamonds, text boxes, lines, connectors and images. Layout tools move, align and distribute shapes. Bounds changes update supported independent polygon/ellipse geometry and local-pin caches; group/master-derived or unsupported formula resizes fail without saving. Layout operates on unrotated top-level 2D shapes. Moves preserve connection records but do not reroute connectors or calculate arbitrary ShapeSheet formulas. Endpoint edits support unglued, independent straight segments; disconnect first and use native Visio for full routing.

Layer tools add, rename, remove and patch layer state. Ordinary new layers explicitly preserve individual shape colours. VsdxSetLayerColor deliberately overrides them; VsdxClearLayerColor removes that override. Connection-point tools add/remove stable indexed points, and VsdxConnect/VsdxDisconnect manage endpoint connection records. Removing a used point requires disconnecting its users first.

Batches such as VsdxAddRectangles, VsdxAddDiamonds, VsdxAddConnectors, VsdxSetFonts, VsdxSetLineStyles, and VsdxSetShapeLayers supply paths once and ordered items. Results provide the actual created IDs; there are no implicit cross-call aliases.

VsdxRender returns a managed PNG even when also saving it, so the operative receives visual feedback. VsdxExport uses installed Microsoft Visio for native PNG/SVG/JPEG/EMF/PDF/XPS export. Managed rendering warns about layer colour overrides it does not reproduce. Review native output before commercial delivery; package validity alone does not establish visual or content quality. VsdxSearchStencils is read-only; VsdxDropStencilMaster requires Visio and commits its destination atomically. Stencil drop coordinates identify the shape centre, unlike ordinary shape-creation bounds.

Evaluation method and observed results are documented in eng/VisioToolEvaluation.md in the repository.

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
3.0.0 56 11/18/2026
2.2.2 46 11/17/2026
2.2.1 87 11/16/2026
2.2.0 98 11/11/2026
2.1.0 101 11/10/2026
2.0.1 141 9/11/2026
2.0.0 163 9/1/2026
1.1.0 142 8/26/2026
1.0.0 132 8/25/2026

Updates dependency to Universal.Operative.Sdk 6.4.0.