Design-Time Features in Windows Forms

18 Nov 20181 minute to read

Overview

We have added design-time support—such as Smart Tags, Custom Collection Editors, and Custom Forms for UITypeEditor—to include controls targeting .NET 6 and higher, which were previously available only in the .NET Framework.

Why We Use the WinForms Designer SDK

Microsoft has introduced the WinForms Designer SDK NuGet package to support custom design-time experiences in Visual Studio for .NET Core and later versions. This SDK replaces the traditional designer APIs that were previously part of the .NET Framework and Windows OS.

The new Designer SDK offers several key advantages:

  • Independent of the operating system
  • Not reliant on the .NET Framework
  • Fully integrated with Visual Studio

It provides essential extension points and base classes that allow developers to implement advanced design-time features such as Smart Tags, Custom Collection Editors, Custom Forms for UITypeEditor.

These features are now available for controls targeting .NET 6 and higher.

To enable this functionality, we have added the WinForms Designer SDK as a dependency in our control NuGet packages starting from this version v26.1.35. This ensures a consistent and enhanced design-time experience across modern .NET platforms, including .NET 6, .NET 7, .NET 8, .NET 9, and later.

Control Package Details

We have added the WinForms Designer SDK as a dependency in the following control packages. Please refer to the table below for details:

Control Package name Designer SDK Dependency Added
Syncfusion.Tools.Windows Yes
Syncfusion.Shared.Base Yes
Syncfusion.Diagram.Windows Yes
Syncfusion.Gauge.Windows Yes
Syncfusion.Grid.Windows Yes
Syncfusion.Grid.Grouping.Windows Yes
Syncfusion.Maps.Windows Yes
Syncfusion.PivotTable.WinForms Yes
Syncfusion.Core.WinForms Yes
Syncfusion.SfInput.WinForms Yes
Syncfusion.Spreadsheet.Windows Yes
Syncfusion.TreeMap.Windows Yes

NOTE

The listed package assemblies are built against the Designer SDK to provide integrated support for designer functionalities.

Limitations

Certain controls properties in .NET Core WinForms have known design‑time limitations. These issues are largely caused by the out‑of‑process WinForms Designer architecture, which results in UITypeEditors, collection editors, and smart tags having only limited communication with the design surface.

We have documented these details in the following Knowledge Base article. Please refer to it for comprehensive information. Refer to the Visual Studio version requirements for the .NET 6 and later WinForms Designer SDK support.

KB Link : Known Design-Time Limitations in .NET Core WinForms and Syncfusion Controls