C# Forms (How it Works For Developers)

Updated November 29, 2023

Introduction to Windows Form Project Type

Windows Forms, commonly referred to as "WinForms", is a graphical user interface (GUI) library in the .NET Framework and .NET Core Framework. With Windows Forms, developers can create rich, interactive desktop applications for Windows. This tutorial will walk you through the steps to create a new project on the basic Windows Forms app using Visual Studio, a popular integrated development environment (IDE) for .NET developers.

Setting Up Visual Studio

Before diving into creating your Windows Forms app, you'll need Visual Studio installed. It's the primary tool used to develop Windows Forms applications.

Installing Visual Studio

Download Visual Studio from the official website.

Run the installer and select the ".NET desktop development" workload. This includes the necessary tools for building Windows Forms applications.

Complete the installation process.

Starting a New Windows Forms Project

  1. Open Visual Studio.
  2. Go to the File option in the menu bar and select New > Project. This will open the 'new project dialog box'.
  3. In the dialog box, search for "Windows Forms App" and select it. Ensure you're choosing the right version based on whether you're using the .NET Core Framework or the older .NET Framework.
  4. Click on Next, give your project a name, and click Create in the dialog box.

You've now successfully created a new Windows Form application!

The Basics of Windows Forms

When you create a new Windows Form application in Visual Studio, a blank form titled 'Form1' will be displayed. This form is the canvas where you'll design your application's GUI.

Understanding the Visual Studio Interface

Solution Explorer: On the right side, the Solution Explorer shows all files and resources in your project. Double-click on 'Form1.cs' here to bring the form into view.

Properties Window: Below the Solution Explorer, the properties window displays the properties of the selected item on the form. Here, you can modify properties like size, color, text, etc in the properties window.

Toolbox: On the left side, this contains all the 'child controls' (like buttons, label control, text boxes) you can drag onto your form.

Adding Controls to Your Form

Adding controls to your form is as easy as dragging and dropping from the toolbox:

  1. Find the Button control in the toolbox and drag it onto your form. This is your 'button control'.
  2. Similarly, drag a Label control (label control) and a CheckBox control (checkbox control) onto your form.
  3. Adjust their positions as needed.

Each of these controls has properties that can be adjusted in the properties window. For instance, select the button control and change its Text property to "Click Me".

Making Your Windows Forms App Interactive

An app is more than just its appearance; it needs functionality!

Adding Event Handlers to Controls

Double-click on the button control you added. Visual Studio will automatically create an event handler in the code behind the form.

In this event handler method, add the following code:

label1.Text = "Button was clicked!";
label1.Text = "Button was clicked!";
label1.Text = "Button was clicked!"
VB   C#

Now, every time you click the button in your Windows form application, the label's text will change to "Button was clicked!".

Running Your Application

Click on the green 'Start' button at the top or press F5. This will compile and run your application. The main method is the entry point of the app, and your form should appear on the screen. Try clicking the button to see your label's text change added within the main method!

Advanced Controls and Features

Grouping Controls

Using the GroupBox control, you can group related controls, enhancing organization and user experience.

  1. From the toolbox, drag a GroupBox onto your form.
  2. Add other controls into this group by dragging them inside the GroupBox.

Using the MenuStrip Control

A MenuStrip control provides a menu bar for your Windows Forms app.

  1. Drag the MenuStrip control from the toolbox onto your form.
  2. Click on it to add menu items like "File", "Edit", etc.

Handling Multiple Forms

A real-world Windows Forms application often uses multiple forms.

  1. Right-click on your project in the solution explorer > Add > New Item.
  2. Choose "Windows Form", name it, and click Add.
  3. To open this new form from your main form, use:
Form2 newForm = new Form2();
Form2 newForm = new Form2();
Dim newForm As New Form2()
VB   C#

Integrating Iron Suite Products into Windows Forms Application

Windows Forms, being a highly flexible platform, allows the integration of third-party tools and libraries to further extend its capabilities. One such notable suite of tools comes from Iron Suite, which comprises a set of powerful products tailored for developers. Let’s delve into these products and see how they can supercharge your Windows Forms applications.

Iron Suite is a compilation of developer tools designed to simplify complex tasks within C# and .NET projects. These tools, while standalone in their capabilities, complement one another, making them ideal for comprehensive projects such as those you might be developing with Windows Forms.


IronPDFIronPDF is a versatile library designed to work with PDFs within the .NET environment. Imagine creating a Windows Forms app that generates reports or manages documents. With IronPDF, you can generate, edit, and even convert PDFs seamlessly. It can easily be integrated into your Windows Forms application, allowing you to provide robust PDF functionalities without much hassle.


IronXL Dealing with Excel files is common in many applications, especially those centered around data management. IronXL is your go-to tool for this purpose. With IronXL, your Windows Forms application can read, write, edit, and even create Excel spreadsheets. This opens up myriad possibilities like creating dynamic reports, managing datasets, or importing/exporting data to and from your application.


IronOCR Optical Character Recognition (OCR) is a technology that converts different types of documents, such as scanned paper documents, PDFs, or images captured by a digital camera, into editable data. IronOCR is a leading tool in this domain. By integrating IronOCR into your Windows Forms application, you can extract text from images, scanned documents, or even PDFs. Think of applications that digitize printed data or tools that assist in document management – IronOCR can be the backbone of these functionalities.


IronBarcode In today’s digital age, barcodes and QR codes are ubiquitous. Whether for inventory management, ticket verification, or product scanning, these codes are essential. IronBarcode allows your Windows Forms application to generate, read, and work with various barcodes and QR codes. Integrating this can lead to more interactive and dynamic applications, especially in retail, event management, or inventory-related projects.


Iron Suite Windows Forms offers a vast landscape for creating interactive applications, and when paired with tools like those from Iron Suite, the possibilities become endless. Each product from Iron Suite, whether it's IronPDF, IronXL, IronOCR, or IronBarcode, starts from $749. What's even more enticing is that each product offers a 30-day free trial, allowing you to test and experience their capabilities fully.

For those looking to maximize value, Iron Suite provides a compelling offer: you can acquire the entire suite for the price of just two products. This not only provides financial savings but also equips you with a comprehensive set of tools to elevate your Windows Forms applications to new heights.

C# Json Serializer (How it Works For Developers)
C# AS (How it Works For Developers)

Ready to get started? Version: 2024.6 just released

Start Free Trial Total downloads: 9,541,998
View Licenses >