{"id":228087,"date":"2020-01-22T08:53:20","date_gmt":"2020-01-22T16:53:20","guid":{"rendered":"https:\/\/devblogs.microsoft.com\/visualstudio\/?p=228087"},"modified":"2020-11-04T14:42:14","modified_gmt":"2020-11-04T22:42:14","slug":"getting-started-with-blazor-server-apps-in-visual-studio-for-mac","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/visualstudio\/getting-started-with-blazor-server-apps-in-visual-studio-for-mac\/","title":{"rendered":"Getting Started with Blazor Server Apps in Visual Studio for Mac"},"content":{"rendered":"

In Visual Studio 2019 for Mac v8.4<\/a> one of the big things that we added support for is developing Blazor Server Applications<\/a>. In this post I\u2019ll show you how you can get started building new Blazor Server applications with Visual Studio for Mac. Blazor lets you build interactive web UIs using C# instead of JavaScript. Blazor apps are composed of reusable web UI components implemented using C#, HTML, and CSS. Both client and server code are written in C#, allowing you to share code and libraries.<\/p>\n

Creating a new Blazor Server Project<\/h2>\n

When you first launch Visual Studio for Mac you will see the dialog that follows:<\/p>\n

\"\"<\/p>\n

To get started you will first click New to begin creating your new Blazor Server app. You can also use the menu option File->New Solution<\/em> as shown below.<\/p>\n

\"\"<\/p>\n

Once you\u2019ve done that, the New Project Dialog will appear. To create a Blazor Server app we will go to the .NET Core -> App<\/em> section and then select Blazor Server App<\/em>:<\/p>\n

\"\"<\/p>\n

After clicking Next, you\u2019ll be prompted to select the .NET Core version. You can select the default value, .NET Core 3.1 at the time of this post, or change it to use a specific version. For Blazor apps, .NET Core 3.0 or newer is required. Once you\u2019ve selected Next, you\u2019ll get to the next page in the wizard where you will give your new project a name. I have named this new project HelloBlazor.<\/p>\n

\"\"<\/p>\n

Now that we have configured our new project we can click Create (or hit the Return key) to create the project. After the project is created, it will be opened in the IDE. I have opened the Index.razor file in Visual Studio for Mac\u2019s editor, which you can see in the screenshot below.<\/p>\n

\"\"<\/p>\n

Now that the project has been created, the first thing that we should do is to run the application to ensure that everything is working as expected. You can start your new Blazor app with Run > Start Debugging<\/em> or Run > Start without Debugging<\/em>.<\/p>\n

\"\"<\/p>\n

In this case, let\u2019s go with Start without Debugging because it launches faster than a debug session, and we are not intending to do any debugging currently. To Start without Debugging you can use the menu option (shown in image above), or you can use the keyboard shortcut \u2325\u2318\u23ce. When you start your application, it will be launched within the default system browser., You can change the launched browser by using the browser selector in the toolbar, shown in next image.<\/p>\n

\"\"<\/p>\n

Let\u2019s start this app with the keyboard shortcut<\/a> for Start without Debugging. After the project is built, the app will be opened in a browser. Now that we have our project up and running, let\u2019s have some fun and customize it a bit.<\/p>\n

In the project that is created there is a Counter page where you can click a button to increment the count. Let\u2019s modify this to page to enable the user to specify the increment value. We can do this by adding an input field onto the Counter page and binding it to a new increment property that is used to increment the counter. Take a look at the updated code for Counter.razor in the following screenshot.<\/p>\n

\"\"<\/p>\n

If you would like to copy and paste the code into your project, a snippet is below.<\/p>\n

\n
@page \"\/counter\"\r\n\r\n<h1>Counter<\/h1>\r\n\r\n<input type=\"number\" min=\"1\" step=\"1\" @bind-value=\"increment\" \/>\r\n<p>Current count: @currentCount<\/p>\r\n\r\n<button class=\"btn btn-primary\" @onclick=\"IncrementCount\">Click me<\/button>\r\n\r\n@code {\r\n    public int increment = 1;\r\n    private int currentCount = 0;\r\n\r\n    private void IncrementCount()\r\n    {\r\n        currentCount += increment;\r\n    }\r\n}<\/pre>\n<\/div>\n
In the code shown above the lines indicated by an arrow are the new, or edited, lines of code. Here we have added a new input field (line 5) for users to configure the increment, we have added a new property increment (line 11) to store the increment value and lastly we have modified line 16 to use the increment value instead of the hard coded increment by 1.<\/p>\n
To ensure that the changes we have made are working as expected, we will start a debugging session. Let\u2019s set a breakpoint when currentCount<\/em> is incremented, line 16. After setting that breakpoint, we will Start Debugging with the keyboard shortcut \u2318\u23ce. When the breakpoint is hit, we can verify that the value for increment is taken from the input field on the Counter page. The animated gif below shows; creating a breakpoint, debugging the application and inspecting the value for increment when the breakpoint is hit.<\/p>\n
\"\"<\/p>\n
If all goes well, the increment value was taken from the input field in the Counter page, and the app is behaving correctly. Now that we\u2019ve shown how you can create, edit and debug a Blazor Server app, it\u2019s time to wrap up this post.<\/p>\n
Recap and next steps<\/h2>\n
In this post we have shown how to create a new Blazor Server application and work with it in Visual Studio for Mac. If you haven\u2019t already, download Visual Studio for Mac<\/a> to get started. If you are an existing Visual Studio for Mac user, update Visual Studio for Mac<\/a> to version 8.4 or newer to get support for Blazor Server apps. In addition to developing Blazor Server apps, you can also publish them to Azure App Services<\/a>.<\/p>\n
If you have any issues while working in Visual Studio for Mac, please Report a Problem<\/a> so that we can improve the product. Before we go, here are some additional resources for you.<\/p>\n
Additional Resources<\/h3>\n
To learn more about the changes in Visual Studio 2019 for Mac v8.4, take a look at the v8.4 release blog post<\/a>.<\/p>\n
Join us for our upcoming Visual Studio for Mac: Refresh() event on February 24<\/a> for deep dive sessions into .NET development using Visual Studio for Mac, including a full session on developing Blazor applications.<\/p>\n
For more info on Blazor a good starting point is Introduction to ASP.NET Core Blazor<\/a>.<\/p>\n
For another guide on creating a Blazor Server application in Visual Studio for Mac head over to the docs at Create Blazor web apps<\/a>.<\/p>\n
Make sure to follow us on Twitter at @VisualStudioMac<\/a> and reach out to the team. Customer feedback is important to us and we would love to hear your thoughts. Alternatively, you can head over to Visual Studio Developer Community<\/a> to track your issues, suggest a feature<\/a>, ask questions, and find answers from others. We use your feedback to continue to improve Visual Studio 2019 for Mac, so thank you again on behalf of our entire team.<\/p>\n","protected":false},"excerpt":{"rendered":"
In Visual Studio 2019 for Mac v8.4 one of the big things that we added support for is developing Blazor Server Applications. In this post I\u2019ll show you how you can get started building new Blazor Server applications with Visual Studio for Mac. Blazor lets you build interactive web UIs using C# instead of JavaScript. […]<\/p>\n","protected":false},"author":357,"featured_media":226537,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[155,1029],"tags":[3743,452,4976],"class_list":["post-228087","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-visual-studio","category-web","tag-visual-studio-2019-for-mac","tag-visual-studio-for-mac","tag-vsmac"],"acf":[],"blog_post_summary":"
In Visual Studio 2019 for Mac v8.4 one of the big things that we added support for is developing Blazor Server Applications. In this post I\u2019ll show you how you can get started building new Blazor Server applications with Visual Studio for Mac. Blazor lets you build interactive web UIs using C# instead of JavaScript. […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/visualstudio\/wp-json\/wp\/v2\/posts\/228087","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/visualstudio\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/visualstudio\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/visualstudio\/wp-json\/wp\/v2\/users\/357"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/visualstudio\/wp-json\/wp\/v2\/comments?post=228087"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/visualstudio\/wp-json\/wp\/v2\/posts\/228087\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/visualstudio\/wp-json\/wp\/v2\/media\/226537"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/visualstudio\/wp-json\/wp\/v2\/media?parent=228087"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/visualstudio\/wp-json\/wp\/v2\/categories?post=228087"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/visualstudio\/wp-json\/wp\/v2\/tags?post=228087"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}