3 min read
Blazor Bites Series
- Creating a new project
- Creating Components
- Component Lifecycle Methods
- Data Binding & Events
Post valid for: Blazor 0.2.0
Please remember that Blazor is an experimental project and is going to be changing regularly. IT IS NOT PRODUCTION READY.
Depending on which development experience you prefer, you can get up and running with Blazor using either Visual Studio 2017 preview or VS Code. Regardless of which you choose you must first install the .NET Core 2.1 preview.
You will need to install the latest preview of Visual Studio 2017. You can run this side-by-side with other versions without issue. When installing the preview make sure you select the ASP.NET and Web Development workload. If you are planning on getting your hand dirty with the Blazor source code, then you will also need to install the Visual Studio extension development features workload.
Once you have installed Visual Studio you then need to install the ASP.NET Core Blazor Language Services extension from the Visual Studio Marketplace. Once these are install you should then be good to go.
If you'd prefer, you can use VS Code for development. However, be aware that there is currently no tooling support available; you will not see any IntelliSense in the editor.
You can install the Blazor project templates with the following commands.
dotnet new -i Microsoft.AspNetCore.Blazor.Templates
Then you can create and run a new application the same as you would any other.
dotnet new blazor -o HelloWorld cd HelloWorld dotnet run
Current known issues/quirks
- There is currently an issue with creating projects with special characters in the name.
- When running a Blazor only app (no backend) you will have to shutdown the server process manually when you finish running your app.
Creating a new project
Once you've installed all the prerequisites, open up Visual Studio 2017 preview and create a new project. To get to the blazor template select the
.NET Core category from the tree menu on the left and then choose
ASP.NET Core Web Application from the list.
You should then see the Blazor templates on the new screen.
As you can see in the screenshot there are 2 project types available today.
Blazor (ASP.NET Core hosted).
Blazor Project Type
This is the project to select when you are interested in creating a client-side only application. There is no backing API included.
Blazor (ASP.NET Core Hosted)
This project is for full stack C# development. You get the same client-side project as with the Blazor only template, but with this template you also get an ASP.NET Core WebAPI project as well.
Once you have selected the project template you want to have a play with, click
OK and you should be looking at a new Blazor project ready to go. You can run the project straight away and you should see the basic start app after a few seconds.
In this post I've covered how to get up a running with Blazor development. Things are moving fast with the project so I will make sure I keep this post up to date with the current changes.