ProDiagnostics.Transport

ProDataGrid

Badge	Package	Downloads
	ProDataGrid
	ProDataGrid.Charting
	ProDataGrid.FormulaEngine
	ProDataGrid.FormulaEngine.Excel
	ProCharts
	ProCharts.Avalonia
	ProCharts.Skia
	ProDiagnostics
	ProDiagnostics.Transport
	ProDiagnostics.Viewer

ProDataGrid is a high-performance DataGrid control for Avalonia.

Quick Start

Install the package:

dotnet add package ProDataGrid

Include the theme in App.axaml:

<Application.Styles>
  <FluentTheme />
  <StyleInclude Source="avares://Avalonia.Controls.DataGrid/Themes/Fluent.v2.xaml" />
</Application.Styles>

<Application.Styles>
  <SimpleTheme />
  <StyleInclude Source="avares://Avalonia.Controls.DataGrid/Themes/Simple.v2.xaml" />
</Application.Styles>

Basic XAML usage:

<DataGrid ItemsSource="{Binding People}"
          AutoGenerateColumns="False"
          UseLogicalScrollable="True">
  <DataGrid.Columns>
    <DataGridTextColumn Header="ID" Binding="{Binding Id}" Width="60" />
    <DataGridTextColumn Header="Name" Binding="{Binding Name}" Width="*" />
    <DataGridCheckBoxColumn Header="Active" Binding="{Binding IsActive}" Width="80" />
  </DataGrid.Columns>
</DataGrid>

Nightly Packages (GitHub Packages)

Nightly builds are published to GitHub Packages with versions like 11.3.9-nightly.20241227.123.

Add the GitHub Packages feed (requires a GitHub token with read:packages):

dotnet nuget add source https://nuget.pkg.github.com/wieslawsoltes/index.json \
  --name github \
  --username YOUR_GITHUB_USERNAME \
  --password YOUR_GITHUB_TOKEN \
  --store-password-in-clear-text

GitHub Packages NuGet docs: https://docs.github.com/en/packages/working-with-a-github-packages-registry/working-with-the-nuget-registry

Install a nightly package:

dotnet add package ProDataGrid --source github --prerelease

Or pin a specific nightly version:

dotnet add package ProDataGrid --source github --version 11.3.9-nightly.20241227.123

Documentation

• DocFX articles: docfx/articles/intro.md
• DocFX entry page: docfx/index.md

Testing

Run standard tests:

dotnet test

Leak tests use Avalonia-style WeakReference/GC checks. Use the helper script to run only leak tests:

.\tools\run-leak-tests.ps1

ProDiagnostics

ProDiagnostics provides Avalonia developer tools UI as a standalone package. It focuses on runtime inspection and debugging:

• Visual and logical tree inspection.
• Property and style inspection with live values.
• Routed event tracking.
• Layout exploration and renderer diagnostics overlays.

Installation

Install from NuGet:

dotnet add package ProDiagnostics

Quick start

Attach DevTools after application initialization:

public override void OnFrameworkInitializationCompleted()
{
    if (ApplicationLifetime is IClassicDesktopStyleApplicationLifetime desktop)
        desktop.MainWindow = new MainWindow();

    base.OnFrameworkInitializationCompleted();
    this.AttachDevTools();
}

By default DevTools opens with F12. You can also attach to a TopLevel or provide a custom key gesture or options.

ProDiagnostics.Transport

ProDiagnostics.Transport streams metrics and activities over UDP so you can observe diagnostics out-of-process.

Installation

Install from NuGet:

dotnet add package ProDiagnostics.Transport

Quick start

Export diagnostics to the viewer:

using ProDiagnostics.Transport;

var exporter = new DiagnosticsUdpExporter(new DiagnosticsUdpOptions
{
    Host = "127.0.0.1",
    Port = TelemetryProtocol.DefaultPort,
    ActivitySourceNames = new[] { "ProDataGrid.*" },
    MeterNames = new[] { "ProDataGrid.Diagnostic.Meter" }
});

exporter.Start();

Keep the exporter alive for the lifetime of the app and dispose it during shutdown.

ProDiagnostics.Viewer

ProDiagnostics.Viewer is an Avalonia UI for live metrics and activities streamed over UDP.

Installation

Install as a global tool:

dotnet tool install -g prodiagnostics-viewer

Quick start

Run the viewer:

prodiagnostics-viewer

License

ProDataGrid is licensed under the MIT License (see licence.md).

ProDiagnostics is licensed under the MIT License (see licence.md).

The original Avalonia.Controls.DataGrid and Avalonia.Diagnostics license is preserved in licence-avalonia.md.