V4 V5

Requirements

  • .NET 10 SDK or later (10.0.301 or above). net48 / net8 are not supported
  • The WinForms and WPF editions are Windows-only. The Avalonia and headless editions run on Windows / Linux / macOS

Choosing a package

You are buildingPackage
A WinForms appunvell.ReoGrid.One
A WPF appunvell.ReoGrid.One.Wpf
An Avalonia app (cross-platform)unvell.ReoGrid.One.Avalonia
Server / batch processing (no UI)unvell.ReoGrid.One.Core

The UI packages include everything — the core, the formula engine and XLSX / PDF I/O. There is no need to reference .Core alongside them (it would be a duplicate reference).

Registering the package feed

The packages are not on nuget.org; they come from UNVELL’s package feed. Register the feed as a NuGet source once, before the first install.

  1. Create a token under Access Tokens in the portal
  2. Register the feed, with your portal email address as the user name and the token as the password
dotnet nuget add source "https://packages.unvell.com/nuget/v3/index.json" \
  --name reogrid \
  --username "[email protected]" \
  --password "<access token>" \
  --store-password-in-clear-text

The same portal page shows this command with your address and token filled in, and a nuget.config example. On CI, pass the token in from an environment variable or a secret.

Installing

dotnet add package unvell.ReoGrid.One

The current version is 5.2.0.

To add it directly to your .csproj:

<ItemGroup>
  <PackageReference Include="unvell.ReoGrid.One" Version="5.2.0" />
</ItemGroup>

WinForms / WPF projects need the target framework set and the UI enabled.

<PropertyGroup>
  <TargetFramework>net10.0-windows</TargetFramework>
  <UseWindowsForms>true</UseWindowsForms>   <!-- for WPF: <UseWPF>true</UseWPF> -->
</PropertyGroup>

Namespaces

Each package is a single DLL, but the namespaces are organized by feature.

NamespaceContents
unvell.ReoGrid.CoreWorkbook, Worksheet, CellPosition, RangePosition
unvell.ReoGrid.Core.StyleStyleRecord, HAlign, VAlign, TextWrap
unvell.ReoGrid.Core.DataCellValue, CellValueKind
unvell.ReoGrid.Core.CellTypesCell types such as checkboxes and dropdowns
unvell.ReoGrid.Core.LicenseReoGridLicense, LicenseInfo
unvell.ReoGrid.WinFormsThe WinForms ReoGridControl
unvell.ReoGrid.WpfThe WPF ReoGridControl
unvell.ReoGrid.AvaloniaThe Avalonia ReoGridControl
unvell.ReoGrid.IO.ExcelXlsxReader, XlsxWriter
unvell.ReoGrid.IO.PdfPdfExporter

Assembly names

The package ID and the assembly name (DLL name) match. For example, unvell.ReoGrid.One is unvell.ReoGrid.One.dll. Use this name when referencing the assembly from XAML (WPF / Avalonia).

In V4, the WinForms and WPF editions shared the same DLL name, unvell.ReoGrid.dll; in V5 they are separate.

The WinForms package also carries the native DLL for Direct2D drawing (runtimes/win-x64/native/d2dlib64.dll, runtimes/win-x86/native/d2dlib32.dll). With a NuGet reference it is copied into your output automatically; an app that draws only with GDI+ runs without it.

Was this article helpful?