Create custom html helper in asp net core


ASP.NET is a popular programming language used for building web applications. One of the key of ASP.NET is the ability to create custom HTML helpers. HTML helpers are methods that HTML markup for various elements in a web page. In this article, we will explore how to create custom HTML helpers in ASP.NET Core.

Step 1: Create a new ASP.NET Core project

To , let's create a new ASP.NET Core project. Open Visual Studio and select “Create a new project”. Choose the ASP.NET Core Web Application template and provide a name for your project. “Create” to create the project.

Step 2: Add a new class for the custom HTML helper

Next, we need to add a new class to our project to the custom HTML helper. Right-click on the project in the Solution and select “Add” > “Class”. Name the class “CustomHtmlHelper” and click “Add”.

Step 3: Implement the custom HTML helper

Open the “CustomHtmlHelper” class and add the following code:


namespace YourNamespace
    public static class CustomHtmlHelper
        public static IHtmlContent CustomButton(this IHtmlHelper htmlHelper, string text)
            var button = new TagBuilder("button");
            button.AddCssClass("btn btn-primary");
            return button;

In this code, we define a static class called “CustomHtmlHelper” with a static method called “CustomButton”. This method takes an instance of the “IHtmlHelper” interface and a string parameter for the button text. Inside the method, we create a new instance of the “TagBuilder” class to generate the HTML markup for the button. We set the button text, add a CSS class, and return the generated button markup.

Step 4: Register the custom HTML helper

To use the custom HTML helper in our , we need to register it in the “Startup.cs” file. Open the “Startup.cs” file and locate the “ConfigureServices” method. Add the following code inside the method:

using YourNamespace;

public void ConfigureServices(IServiceCollection services)
    //  configuration code


In this code, we register the “CustomHtmlHelper” class as a singleton service for the “IHtmlHelper” interface. This allows us to use the custom HTML helper in our views.

Step 5: Use the custom HTML helper in a view

Now that we have created and registered the custom HTML helper, we can use it in our views. Open a view file (e.g., “Index.cshtml”) and add the following code:

@using YourNamespace

    ViewData[""] = "Home";

Welcome to the Home Page

@Html.CustomButton("Click me!")

In this code, we first import the namespace of our custom HTML helper using the “@using” directive. Then, we use the “@Html” helper to call our custom HTML helper method “CustomButton” and pass the button text as a parameter.


In this article, we have learned how to create custom HTML helpers in ASP.NET Core. Custom HTML helpers allow us to generate reusable HTML markup for elements in our web pages. By following the steps outlined in this article, you can create your own custom HTML helpers and use them in your ASP.NET Core projects.

Rate this post

Leave a Reply

Your email address will not be published. Required fields are marked *

Table of Contents