Getting started with Syncfusion Blazor components in Blazor ASP.NET Core Hosted App using Visual Studio 2019

6 Aug 20216 minutes to read

This article provides step-by-step instructions about how to create Blazor ASP.NET Core Hosted application using Visual Studio 2019 with Syncfusion Blazor components setup pre-configured in it.

Starting with version 17.4.0.39 (2019 Volume 4), you need to include a valid license key (either paid or trial key) within your applications. Please refer to this help topic for more information.

Prerequisites

.NET Core SDK 3.1.8 requires Visual Studio 2019 16.7 or later.
.NET 5.0 requires Visual Studio 2019 16.8 or later.

Create a Blazor ASP.NET Core Hosted project in Visual Studio 2019

  1. Choose Create a new project from the Visual Studio dashboard.

    new project in aspnetcore blazor

  2. Choose Blazor WebAssembly App from the dashboard, and then click the Next button to create a new Blazor WebAssembly application.

    wasm template

  3. Now, the project configuration window will popup. Click the Next button to create a new project with the default project configuration.

    project configuration

  4. Select the target Framework .NET Core 3.1 or .NET 5.0 at the top of the Application based on your required target.

    select framework

  5. Then check the ASP.NET Core Hosted option and click Create button to create a new Blazor ASP.NET Core Hosted application.

    select framework

  6. The application will have the following structure once project is created.

    project structure

Installing Syncfusion Blazor packages in the application

You can use any one of the following standards to install the Syncfusion Blazor library in your application.

Using Syncfusion Blazor individual NuGet Packages [New standard]

Starting with Volume 4, 2020 (v18.4.0.30) release, Syncfusion provides individual NuGet packages for our Syncfusion Blazor components. We highly recommend this new standard for your Blazor production applications. Refer to this section to know the benefits of the individual NuGet packages.

  1. Now, install the Syncfusion.Blazor.Calendars NuGet package to the new application using the NuGet Package Manager. For more details about available NuGet packages, refer to the Individual NuGet Packages documentation.

  2. Right-click on the Client[BlazorWasmHosted.Client] project ,and then select Manage NuGet Packages.

    nuget explorer

  3. Search Syncfusion.Blazor.Calendars keyword in the Browse tab and install Syncfusion.Blazor.Calendars NuGet package in the application.

    select nuget

  4. The Syncfusion Blazor Calendars package will be included in the newly created project once the installation process is completed.

  5. Add the Syncfusion bootstrap4 theme in the <head> element of the ~/wwwroot/index.html page in Client[BlazorWasmHosted.Client] project.

     <head>
         ....
         ....
         <link href="_content/Syncfusion.Blazor.Themes/bootstrap4.css" rel="stylesheet" />
     </head>

    WARNING

    Syncfusion.Blazor package should not be installed along with individual NuGet packages. Hence, you have to add the above Syncfusion.Blazor.Themes static web assets (styles) in the application.

Using Syncfusion.Blazor NuGet Package [Old standard]

WARNING

If you prefer the above new standard (individual NuGet packages), then skip this section. Using both old and new standards in the same application will throw ambiguous compilation errors.

  1. Now, install the Syncfusion.Blazor NuGet package to the newly created application by using the NuGet Package Manager. Right-click on the Client[BlazorWasmHosted.Client] project and then select Manage NuGet Packages.

    nuget explorer

  2. Search Syncfusion.Blazor keyword in the Browse tab and install Syncfusion.Blazor NuGet package in the application.

    select nuget

  3. The Syncfusion Blazor package will be installed in the project once the installation process is completed.

  4. Add the Syncfusion bootstrap4 theme in the <head> element of the ~/wwwroot/index.html page in Client[BlazorWasmHosted.Client] project.

     <head>
         ....
         ....
          <link href="_content/Syncfusion.Blazor/styles/bootstrap4.css" rel="stylesheet" />
     </head>

    The same theme file can be referred through the CDN version by using https://cdn.syncfusion.com/blazor/19.2.49/styles/bootstrap4.css.

Adding Syncfusion Blazor component and running the application

  1. Open ~/_Imports.razor file in Client[BlazorWasmHosted.Client] project and import the Syncfusion.Blazor namespace.

     @using Syncfusion.Blazor
     @using Syncfusion.Blazor.Calendars
  2. Open the ~/Program.cs file in the Client[BlazorWasmHosted.Client] project and register the Syncfusion Blazor Service.

     using Syncfusion.Blazor;
    
     namespace BlazorWasmHosted.Client
     {
         public class Program
         {
             public static async Task Main(string[] args)
             {
                 ....
                 ....
                 builder.Services.AddSyncfusionBlazor();
                 await builder.Build().RunAsync();
             }
         }
     }

    We can disable the dynamic script loading and refer to the scripts from the application end by using the IgnoreScriptIsolation parameter in AddSyncfusionBlazor() at the program.cs. For more details, please refer here for how to refer custom/CDN resources.

  3. Now, add the Syncfusion Blazor component in any web page (razor) in the Pages folder of Client[BlazorWasmHosted.Client] project. For example, the calendar component is added to the ~/Pages/Index.razor page.

     <SfCalendar TValue="DateTime"></SfCalendar>
  4. Run the application. Then, the Syncfusion Blazor Calendar component will be rendered in the default web browser.

    output

    For ASP.NET Core Hosted Blazor application, the Server[BlazorWasmHosted.Server] project should be the startup project.

See Also