Click here to Skip to main content
15,867,453 members
Articles / Desktop Programming / Windows Forms
Article

Embedding a .NET WinForms Application in an Internet Browser Using WPF

Rate me:
Please Sign up or sign in to vote.
4.88/5 (38 votes)
2 Dec 2008CPOL4 min read 272K   6.9K   112   42
Embedding a .NET WinForms application in an internet browser using WPF.

Introduction

This article will describe how to embed a .NET Windows Forms application in a web browser using a WPF browser application. Basically, this article will show you how to web enable any Windows Forms .NET application with very few modifications to your project and no code modifications to your WinForms app.

Now, I realize that this is cheating, this article does not actually show you how to convert a .NET Windows Forms application to WPF. If you want to take advantage of all the features that come with WPF, eventually, you will need to re-write your GUI into WPF. However, if in the short term it is not feasible to convert all of your GUI code into WPF, then this solution is a primitive workaround that enables you to host your applications online.

Creating a sample Windows Forms application

The first step in this article will be to create a simple Windows Forms C# application. This can be any WinForms application, but for the purpose of this article, I will create a small application that calculates a Fibonacci number and displays it on the user interface. This WinForms application can be in either .NET 2.0 or 3.5.

1_VisualStudioCreateWinFormProject.jpg

My application will have a form called MainForm, a button called btnCalculate, and a text box called txtResult.

2_Fibonacci_WindowsForm.jpg

Here is the code for the button click event and the Fibonacci calculation:

C#
static int Fibonacci(int x)
{
    if (x <= 1)
    {
        return 1;
    }
    return Fibonacci(x - 1) + Fibonacci(x - 2);
}

private void btnCalculate_Click(object sender, EventArgs e)
{
    txtResult.Text = Fibonacci(10).ToString();
}

Now that we have our sample application, the next step is to convert it to a Class Library. Right click on your project and choose Properties. Under the Application tab in the Output type combo box, choose Class Library, save, and rebuild.

3_ChangeProjectTypeToClassLibrary.jpg

Note, in order to have your application be referenced in WPF, this is the only change you will have to make to your Windows Forms project.

Creating a WPF browser host application

The next step will be to create a WPF browser application. You can do this within the same solution as your Windows Forms application, or in a new solution. In this sample, I am simply going to add the WPF browser application project to the same solution. I have called this new project WPFHost.

4_CreateWPFBrowserApplicationProject.jpg

The first thing we are going to do is add a reference from our WPFHost project to our WinForms Fibonacci application.

5_AddReference.jpg

Since the WinForms project is in the same solution, we will add the reference to the Fibonacci project. If the WinForms application was in a different solution, we would browse to the created DLL and add a reference to it.

6_AddReference.jpg

We will also need to add a reference to the Windows Forms Integration and System Windows Forms Component in the .NET tab.

7_AddReferenceWindowsFormsIntegration.jpg

8_AddReferenceSystemWindowsForms.jpg

The next step will be to add a StackPanel to our Page1 XAML window.

Image 9

The full XAML for Page1.xaml is:

XML
<Page x:Class="WPFHost.Page1"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    Title="Page1">
    <Grid>
        <StackPanel Margin="0,0,0,0" Name="stackPanel" 
           HorizontalAlignment="Left" VerticalAlignment="Top" />
    </Grid>
</Page>

OK, we are almost there. The next step will be to add some code to Page1.xaml.cs in our project. The magic will happen in the Page1 constructor. Our code will create a WindowsFormHost object and assign the previously created MainForm object from our Fibonacci assembly as the child. The WindowsFormHost will then be added as a child to our WPF StackPanel. The only other obscure line of code sets the TopLevel property of the MainForm object to false. I am not sure why this is required, but you will get a compile error if you do not add this step.

The code looks as follows:

C#
using System.Windows.Controls;
using System.Windows.Forms.Integration;
using Fibonacci;

namespace WPFHost
{
    /// <summary>
    /// Interaction logic for Page1.xaml
    /// </summary>
    public partial class Page1 : Page
    {
        private readonly MainForm mainForm = new MainForm();

        public Page1()
        {
            InitializeComponent();

            //Create a Windows Forms Host to host a form
            WindowsFormsHost windowsFormsHost = new WindowsFormsHost();
            
            stackPanel.Width = mainForm.Width;
            stackPanel.Height = mainForm.Height;
            windowsFormsHost.Width = mainForm.Width;
            windowsFormsHost.Height = mainForm.Height;
          
            mainForm.TopLevel = false;

            windowsFormsHost.Child = mainForm;

            stackPanel.Children.Add(windowsFormsHost);
        }
    }
}

Don’t forget to Save.

OK, this is the last step, I promise. It is also the most obscure one that took me some time to figure out. When I first created the WPF project, I could get this code to work in a regular WPF application, but I always received a weird error when I tried it in a WPF browser application. I almost gave up, thinking that maybe it is not possible to host a Windows Forms application in a web browser. At the end, I found a post on Google groups that gave me the solution. The last step is to right click on the WPFHost project, choose Properties, and navigate to the Security tab. In the tab, change the radio button from “This is a partial trust application” to “This is a full trust application”.

10_FullTrustApplication.jpg

OK, I lied, there is one more step. Right click on your WPFHost project and choose “Set as Startup Project”.

Save, Compile, and Run. You should see your default web browser open with the following page:

11_FinalOutput.jpg

Conclusion

That’s it. If you wish to embed the created .xbap in an HTML web page, you can use the <iframe> tag as follows:

XML
<iframe src="WPFHost.xbap" width="329" height="443" />

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)


Written By
Canada Canada

Comments and Discussions

 
Questionimplementation Pin
Member 1570875711-Mar-24 4:51
Member 1570875711-Mar-24 4:51 
Questionwin10 + vs2019. Could not find file '.exe.manifest'. Pin
chascos6920-Oct-20 22:32
chascos6920-Oct-20 22:32 
QuestionI NEED VB.NET VERSION Pin
Member 1496857819-Oct-20 3:32
Member 1496857819-Oct-20 3:32 
QuestionApplying this solution in a Visual Basic project Pin
Louis Nahas24-Dec-17 22:38
Louis Nahas24-Dec-17 22:38 
AnswerRe: Applying this solution in a Visual Basic project Pin
Stéphane Desserey5-Jan-21 6:19
Stéphane Desserey5-Jan-21 6:19 
Hello,
You can use any online converter to do so; as an example Code Converter C# to VB and VB to C# – Telerik[^]
QuestionThank you for your EXAMPLE !!! Pin
Member 20570898-May-17 3:11
Member 20570898-May-17 3:11 
QuestionAwesome Pin
Saravanan Sivabal24-Apr-17 8:07
Saravanan Sivabal24-Apr-17 8:07 
QuestionLaunching WinForm Project From WPF App Pin
kjward14-Nov-16 10:14
kjward14-Nov-16 10:14 
QuestionCouldnt find file .manifest Pin
AmalRaj@Sync7-Dec-15 22:00
AmalRaj@Sync7-Dec-15 22:00 
QuestionCouldnt find file .manifest Pin
AmalRaj@Sync7-Dec-15 17:47
AmalRaj@Sync7-Dec-15 17:47 
QuestionExcellent article, Thx a lot Pin
Kumar_Vaddadi20-Apr-15 20:09
Kumar_Vaddadi20-Apr-15 20:09 
AnswerRe: Excellent article, Thx a lot Pin
Manikandan Sekar3-Jul-19 19:02
professionalManikandan Sekar3-Jul-19 19:02 
Questiongood Job Pin
edotom24-Feb-15 3:25
edotom24-Feb-15 3:25 
QuestionProblem to show output Pin
Member 1054917521-Jan-15 22:27
Member 1054917521-Jan-15 22:27 
QuestionC# menuitem are missing in WPF webpage Pin
CSUH12-Aug-13 18:25
CSUH12-Aug-13 18:25 
Questionnot working Pin
jagadeesh25306-May-13 22:02
jagadeesh25306-May-13 22:02 
AnswerRe: not working Pin
Member 1187482724-Oct-16 23:25
Member 1187482724-Oct-16 23:25 
GeneralMy vote of 5 Pin
Reza Ahmadi16-Apr-13 7:03
Reza Ahmadi16-Apr-13 7:03 
Questioncall wpf browser application from web application Pin
hishhhh22-Mar-13 23:25
hishhhh22-Mar-13 23:25 
QuestionProblem running the winform application after adding WPF project Pin
siddiqueimran26-Feb-13 7:47
siddiqueimran26-Feb-13 7:47 
QuestionYou saved my bacon ... Pin
Reg Hammond1-Oct-12 8:12
Reg Hammond1-Oct-12 8:12 
GeneralThanks Pin
brian keem3-Jun-12 20:48
brian keem3-Jun-12 20:48 
GeneralMy vote of 5 Pin
ermawindelyn1-Aug-10 18:21
ermawindelyn1-Aug-10 18:21 
QuestionCan we create a wrapper for any kind of windows application. Pin
Ephraim Injamuri23-Feb-10 13:25
Ephraim Injamuri23-Feb-10 13:25 
GeneralIIS installation and XBAP usage Pin
glenn_goodwin84-Jan-10 20:03
glenn_goodwin84-Jan-10 20:03 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.