{"id":24761,"date":"2019-09-30T14:00:10","date_gmt":"2019-09-30T21:00:10","guid":{"rendered":"https:\/\/devblogs.microsoft.com\/dotnet\/?p=24761"},"modified":"2019-09-30T13:46:36","modified_gmt":"2019-09-30T20:46:36","slug":"introducing-net-core-windows-forms-designer-preview-1","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/dotnet\/introducing-net-core-windows-forms-designer-preview-1\/","title":{"rendered":"Introducing .NET Core Windows Forms Designer Preview 1"},"content":{"rendered":"<h2>Introducing .NET Core Windows Forms Designer Preview 1<\/h2>\n<p>We just released a GA version of .NET Core 3.0 that includes support for Windows Forms and WPF. And along with that release we&#8217;re happy to announce the first preview version of the Windows Forms Designer for .NET Core projects!<\/p>\n<p><img decoding=\"async\" src=\"https:\/\/devblogs.microsoft.com\/dotnet\/wp-content\/uploads\/sites\/10\/2019\/09\/winforms-designer-1.png\" alt=\"\" width=\"1015\" height=\"751\" class=\"alignnone size-full wp-image-24785\" srcset=\"https:\/\/devblogs.microsoft.com\/dotnet\/wp-content\/uploads\/sites\/10\/2019\/09\/winforms-designer-1.png 1015w, https:\/\/devblogs.microsoft.com\/dotnet\/wp-content\/uploads\/sites\/10\/2019\/09\/winforms-designer-1-300x222.png 300w, https:\/\/devblogs.microsoft.com\/dotnet\/wp-content\/uploads\/sites\/10\/2019\/09\/winforms-designer-1-768x568.png 768w\" sizes=\"(max-width: 1015px) 100vw, 1015px\" \/><\/p>\n<p>For developers the .NET Core Windows Forms Designer (when we will release the GA version) will look and feel the same as the .NET Framework Windows Forms Designer. But for us it is a huge technical challenge to bring the designer to .NET Core because it requires the design surface that hosts the live .NET Core form to run outside the Visual Studio process. That means we need to re-architect the way the designer surface \u201ccommunicates\u201d with Visual Studio. You can watch these communications in the Output Window, where we track each request sent when the Visual Studio components are accessing properties or executing methods on the live controls in the design surface. The engineering team is still working on this technical challenge, and we will be releasing the Preview versions on regular basis to give you the early glance at the .NET Core Designer. Stay tuned! The next Preview will be coming out in early November.<\/p>\n<p>Because this is the very first preview of the designer, it isn&#8217;t yet bundled with Visual Studio and instead is available as a Visual Studio extension (&#8220;VSIX&#8221;) (<a href=\"https:\/\/aka.ms\/winforms-designer\">download<\/a>). That means that if you open a Windows Forms project targeting .NET Core in Visual Studio, <strong>it won&#8217;t have the designer support by default &#8211; you need to install the .NET Core Designer first!<\/strong><\/p>\n<h2>Enabling the designer<\/h2>\n<p>To enable the designer, download and install the <a href=\"https:\/\/aka.ms\/winforms-designer\">Windows Forms .NET Core Designer VSIX package<\/a>. You can remove it from Visual Studio at any time. After you install the .NET Core Designer, Visual Studio will automatically pick the right designer (.NET Core or .NET Framework) depending on the target framework of the project you&#8217;re working on.<\/p>\n<ul>\n<li><a href=\"https:\/\/aka.ms\/winforms-designer\">Download<\/a><\/li>\n<li><a href=\"https:\/\/github.com\/dotnet\/winforms\/tree\/master\/Documentation\/designer-releases\">Release Notes<\/a><\/li>\n<li><a href=\"https:\/\/github.com\/dotnet\/winforms\/blob\/master\/Documentation\/designer-releases\/0.1\/knownissues.md\">Known Issues<\/a><\/li>\n<\/ul>\n<h2>It is early days for the designer, here is what to expect\u2026<\/h2>\n<p>Please keep in mind, that this is the first preview, so the experience is limited. We support the most commonly used controls and base operations and will be adding more in each new Preview version. Eventually, we will bring the .NET Core Designer at parity with the Windows Forms Designer for .NET Framework.<\/p>\n<p>Because many controls aren&#8217;t yet supported in Preview 1 of the designer, <strong>we don\u2019t recommend porting your Windows Forms applications to .NET Core just yet<\/strong> if you need to use the designer on a regular basis. This Preview 1 is good for \u201cHello World\u201d scenarios of creating new projects with common controls.<\/p>\n<p>Controls included in Preview 1:<\/p>\n<ul>\n<li>Pointer<\/li>\n<li>Button<\/li>\n<li>Checkbox<\/li>\n<li>CheckedListBox<\/li>\n<li>ComboBox<\/li>\n<li>DateTimePicker<\/li>\n<li>Label<\/li>\n<li>LinkLabel<\/li>\n<li>ListBox<\/li>\n<li>ListView<\/li>\n<li>MaskedTextBox<\/li>\n<li>MonthCalendar<\/li>\n<li>NumericUpDown<\/li>\n<li>PictureBox<\/li>\n<li>ProgressBar<\/li>\n<li>RadioButton<\/li>\n<li>RichTextBox<\/li>\n<li>TextBox<\/li>\n<li>TreeView<\/li>\n<\/ul>\n<p>What is not supported in Preview 1:<\/p>\n<ul>\n<li>Container<\/li>\n<li>Resources<\/li>\n<li>Component Tray<\/li>\n<li>In-place editing<\/li>\n<li>Designer Actions<\/li>\n<li>Databinding<\/li>\n<li>User Controls\/Inherited Controls<\/li>\n<\/ul>\n<h2>Give us your feedback!<\/h2>\n<p>We are putting out our first bits so early to support the culture of developing the product with our users\u2019 early feedback in mind. Please do reach out with your suggestions, issues and feature requests via Visual Studio Feedback channel. To do so, click on <strong>Send Feedback<\/strong> icon in Visual Studio top right corner as it is shown on the picture below.<\/p>\n<p><img decoding=\"async\" src=\"https:\/\/devblogs.microsoft.com\/dotnet\/wp-content\/uploads\/sites\/10\/2019\/09\/feedback-300x172.png\" alt=\"\" width=\"300\" height=\"172\" class=\"alignnone size-medium wp-image-24764\" srcset=\"https:\/\/devblogs.microsoft.com\/dotnet\/wp-content\/uploads\/sites\/10\/2019\/09\/feedback-300x172.png 300w, https:\/\/devblogs.microsoft.com\/dotnet\/wp-content\/uploads\/sites\/10\/2019\/09\/feedback.png 337w\" sizes=\"(max-width: 300px) 100vw, 300px\" \/><\/p>\n<p>We appreciate your engagement!<\/p>\n<h2>Addressing Questions<\/h2>\n<h3>What to do if Windows Forms Designer doesn\u2019t work?<\/h3>\n<p>We heard some question related to the Windows Forms Designer not working. Here\u2019s what could have happened:<\/p>\n<ol>\n<li>\n<p>You might have created a .NET Core Windows Forms project instead of the traditional .NET Framework one without realizing it. If you type \u201cWinForms\u201d or \u201cWindows Forms\u201d in the New Project Dialog, the first option would be a .NET Core Windows Forms project. If your intention is to create a .NET Framework project (with the mature designer support), just find and select <strong>Windows Forms App (.NET Framework)<\/strong>. <img decoding=\"async\" src=\"https:\/\/devblogs.microsoft.com\/dotnet\/wp-content\/uploads\/sites\/10\/2019\/09\/new-project-300x208.png\" alt=\"\" width=\"600\" height=\"416\" class=\"alignnone size-medium wp-image-24767\" srcset=\"https:\/\/devblogs.microsoft.com\/dotnet\/wp-content\/uploads\/sites\/10\/2019\/09\/new-project-300x208.png 300w, https:\/\/devblogs.microsoft.com\/dotnet\/wp-content\/uploads\/sites\/10\/2019\/09\/new-project-768x533.png 768w, https:\/\/devblogs.microsoft.com\/dotnet\/wp-content\/uploads\/sites\/10\/2019\/09\/new-project.png 1024w\" sizes=\"(max-width: 600px) 100vw, 600px\" \/><\/p>\n<\/li>\n<li>\n<p>If you want to work with .NET Core project, don\u2019t forget to install the .NET Core Windows Forms Designer, since it isn&#8217;t yet shipped inside Visual Studio by default. See the previous \u201cEnabling the designer\u201d section.<\/p>\n<\/li>\n<\/ol>\n<h3>Does .NET Core WPF Designer depend on Windows Forms Designer installation?<\/h3>\n<p>We also received some questions related to the .NET Core WPF Designer not working and if it requires a separate installation or the Windows Forms Designer installation. No, the WPF Designer is completely independent of the Windows Forms Designer. We released its GA version of the WPF .NET Core Designer at the same time as .NET Core 3.0 and it comes with Visual Studio. In Visual Studio version 16.3.0 we had an issue with the <strong>Enable XAML Designer<\/strong> property set to false by default. That means that when you click on .xaml files, the designer doesn&#8217;t open automatically. Upgrade to the latest Visual Studio version 16.3.1 where this issue is fixed. Another option to fix it is to go to <strong>Tools<\/strong> -> <strong>Options<\/strong> -> <strong>XAML Designer<\/strong> and check <strong>Enable XAML Designer<\/strong>.<\/p>\n<p><img decoding=\"async\" src=\"https:\/\/devblogs.microsoft.com\/dotnet\/wp-content\/uploads\/sites\/10\/2019\/09\/enable-wpf-1.png\" alt=\"\" width=\"762\" height=\"446\" class=\"alignnone size-full wp-image-24772\" srcset=\"https:\/\/devblogs.microsoft.com\/dotnet\/wp-content\/uploads\/sites\/10\/2019\/09\/enable-wpf-1.png 762w, https:\/\/devblogs.microsoft.com\/dotnet\/wp-content\/uploads\/sites\/10\/2019\/09\/enable-wpf-1-300x176.png 300w\" sizes=\"(max-width: 762px) 100vw, 762px\" \/><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Introducing .NET Core Windows Forms Designer Preview 1 We just released a GA version of .NET Core 3.0 that includes support for Windows Forms and WPF. And along with that release we&#8217;re happy to announce the first preview version of the Windows Forms Designer for .NET Core projects! For developers the .NET Core Windows Forms [&hellip;]<\/p>\n","protected":false},"author":365,"featured_media":58792,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[685],"tags":[],"class_list":["post-24761","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-dotnet"],"acf":[],"blog_post_summary":"<p>Introducing .NET Core Windows Forms Designer Preview 1 We just released a GA version of .NET Core 3.0 that includes support for Windows Forms and WPF. And along with that release we&#8217;re happy to announce the first preview version of the Windows Forms Designer for .NET Core projects! For developers the .NET Core Windows Forms [&hellip;]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/posts\/24761","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/users\/365"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/comments?post=24761"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/posts\/24761\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/media\/58792"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/media?parent=24761"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/categories?post=24761"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/tags?post=24761"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}