Syncfusion WinForms Template Studio

23 Apr 20246 minutes to read

The WinForms Template Studio by Syncfusion is a specialized tool for constructing applications with their WinForms components. This studio simplifies development by incorporating crucial Syncfusion components, handling required NuGet references, offering preset namespaces, and creating component render code. Acting as a wizard, it facilitates the creation of WinForms applications using Syncfusion components, streamlining the process for developers.

IMPORTANT

The Syncfusion WinForms Template Studio is available from v24.1.41.

NOTE

WinForms Template Studio is compatible with Visual Studio 2022, Visual Studio 2019, and Visual Studio 2017. For the Visual Studio 2015 or lower versions, it is recommended to use a WinForms project template.

Create the Syncfusion WinForms project using the Visual Studio Project Template by following the provided steps.

Check whether the WinForms Extensions - Syncfusion are installed or not in Visual Studio Extension Manager by going to Extensions -> Manage Extensions -> Installed for Visual Studio 2019 or later, and for Visual Studio 2017 by going to Tools -> Extensions and Updates -> Installed. If this extension is not installed, please install the extension by following the steps from the download and installation help topic.

  1. Open the Visual Studio 2022.

  2. Select one of the following options to create the Syncfusion WinForms application

    Option 1:
    Choose Extension -> Syncfusion -> Essential Studio for WinForms -> Create New Syncfusion Project… from the Visual Studio menu.

    Choose Syncfusion WinForms Application from Visual Studio new project dialog via Syncfusion menu

    NOTE

    In Visual Studio 2017, you can see the Syncfusion menu directly in the Visual Studio menu.

    Option 2:
    Choose File -> New -> Project from the menu. This launches a new dialogue for creating a new application. Filtering the application type by Syncfusion or typing Syncfusion as a keyword in the search option can help you find the Syncfusion templates for WinForms.

    Choose Syncfusion WinForms Application from Visual Studio new project dialog

  3. Select the Syncfusion WinForms Template Studio and click Next.

    Choose Syncfusion WinForms Application from Visual Studio new project dialog

  4. When you launch the Syncfusion WinForms Template Studio, you will encounter a configuration wizard that allows you to set up your Syncfusion WinForms application. Within this wizard, you will have the option to specify your preferred .NET Core Version or .NET Framework Version, select the desired language(CSharp or Visual Basic), and choose the reference type according to your requirements.

    Syncfusion WinForms project configuration wizard

    NOTE

    The installed location and GAC options will be available only after the Syncfusion Essential WinForms setup has been installed. Use the NuGet option instead of installing the Syncfusion Essential WinForms setup. Also, the GAC option will not be available when you choose .NET 6.0, .NET 7.0, and .NET 8.0 from the project type option in Visual Studio.

    IMPORTANT

    Visual Basic Language support is available in WinForms Template Studio starting from version 25.1.35.

  5. Navigate to the Type tab and choose the Syncfusion WinForms application type you want. When selecting the type of template for your application, you have two options:

    Syncfusion WinForms project type selection wizard

    Predefined template: Choose this option to select from 5 predefined templates, including Calendar, Contact, Outlook, Docking Manager, and Spreadsheet. By choosing one of these templates, you can create your application without needing to follow any further steps.

    Syncfusion WinForms Predefined template wizard

    Project type: Choose this option to select from 4 project types, including Blank, Menu Bar, Ribbon, and Tabbed Form.

    1. Click Next or navigate to the Pages tab to access a list of available Syncfusion WinForms components you can add to the application.

      Syncfusion WinForms pages selection wizard

      To unselect the added control(s), Click ‘x’ for the corresponding control in the control list from the Project Details.

      NOTE

      The Control Features option is not accessible for Blank Pages.

    2. Click Next or navigate to the Control Features tab to view the listed features for the selected controls. From here, choose the features needed.

      Syncfusion WinForms control features selection wizard

    3. Click Next or navigate the App Features tab to select the desired application features.

      Syncfusion WinForms app features selection wizard

      NOTE

      The App Features option is not accessible for .NET Framework.

    Project Details Section

    In the Project Details section, modify configurations and project types. Additionally, you can remove one or more controls from the selected list and remove the chosen application feature.

    Syncfusion WinForms project details selection and unselection wizard

  6. Click Create to initiate the process. This action generates the Syncfusion WinForms application. The resulting Syncfusion WinForms app has the necessary Syncfusion NuGet packages, styles, and rendering code specific to the chosen Syncfusion component.

    Syncfusion WinForms project created with readme

  7. The Syncfusion WinForms app is set up with the latest Syncfusion WinForms NuGet packages, including the right namespaces and rendering code. This ensures smooth integration of Syncfusion components.

    NOTE

    The .NET 6.0, .NET 7.0, and .NET 8.0 option will be listed in Select a framework version when only the .NET 6.0, .NET 7.0, and .NET 8.0 SDK setup has been installed.

    .NET 6.0 version is available from v19.4.0.38 and it support from Visual Studio 2022.

    .NET 7.0 version is available from v20.4.0.38 and it support from Visual Studio 2022.

    .NET 8.0 version is available from v23.2.4 and it support from Visual Studio 2022.

  8. If you install the trial setup or NuGet packages from nuget.org, you must register the Syncfusion license key to your application since Syncfusion introduced the licensing system from the 2018 Volume 2 (v16.2.0.41) Essential Studio release. Navigate to the help topic to generate and register the Syncfusion license key to your application. Refer to this blog post for understanding the licensing changes introduced in Essential Studio.

    Syncfusion license registration required information dialog in Syncfusion WinForms project