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 building | Package |
|---|---|
| A WinForms app | unvell.ReoGrid.One |
| A WPF app | unvell.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.
- Create a token under Access Tokens in the portal
- 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.
| Namespace | Contents |
|---|---|
unvell.ReoGrid.Core | Workbook, Worksheet, CellPosition, RangePosition |
unvell.ReoGrid.Core.Style | StyleRecord, HAlign, VAlign, TextWrap |
unvell.ReoGrid.Core.Data | CellValue, CellValueKind |
unvell.ReoGrid.Core.CellTypes | Cell types such as checkboxes and dropdowns |
unvell.ReoGrid.Core.License | ReoGridLicense, LicenseInfo |
unvell.ReoGrid.WinForms | The WinForms ReoGridControl |
unvell.ReoGrid.Wpf | The WPF ReoGridControl |
unvell.ReoGrid.Avalonia | The Avalonia ReoGridControl |
unvell.ReoGrid.IO.Excel | XlsxReader, XlsxWriter |
unvell.ReoGrid.IO.Pdf | PdfExporter |
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.
Read next
- Getting started with WinForms
- Applying a license key — a key is required; without one, file I/O is refused and editing is disabled