Custom Control in ASP.NET C#

Question

I created a simple custom control that only inherits from the Literal control, and doesn't have any extensions yet, code is empty.

Namespace: CustomControls

Class name: Literal : System.Web.UI.WebControls.Literal

Next thing I do is registering this control in the aspx page as following:

<%@ Register TagPrefix="web" Namespace="CustomControls" %>

(I read in few tutorials that this is one of the ways to register it, besides web.config etc.)

After all, no intellisence for me, and worse- I get a parse error 'unknown server tag: web' when I try to run the page with the control in it.

I used 'create new project' and not new website, in case this info is needed.

What could be my problem?

Thanks in advance.

Answer 1

Here is how I did it, step by step starting from nothing. This first method uses a second project/assembly. For the App_code version scroll down.

Web Application Project Method

1. Create a new ASP.Net Web Application. Take note of the name, mine is called WebApplication2. If you already have an existing web application, which is likely, double click the properties section of your project and check the "Assembly Name" property, make note of it.
2. Create a new Class in the web applcation named Literal.cs

3. Put in code similar to the following for the class defenition:

   namespace CustomControls
   {
       public class Literal : System.Web.UI.WebControls.Literal
       {
       }
   }
   

4. Add the following register tag to the top of your aspx page

   <%@ Register assembly="WebApplication2" namespace="CustomControls" tagprefix="web" %>

If your assembly name was different then change it here. I noticed that when I did this in VB.Net the namespace was WebApplication1.CustomControls instead of just CustomControls like it was in C#, kind of odd.

1. Add the new control to your page:

   <web:Literal ID="Literal1" runat="server" Text="test" />

Seperate Project Method

1. Create a new Empty Website (ASP.Net).
2. Add a new ASP.Net Server Control library named CustomControls to the solution.

3. Add a new Class to the new project called Literal (I'm using C# so my file is named Literal.cs). Below is my super basic code, that I believe should match the code described in the question.

   namespace CustomControls
   {
       public class Literal : System.Web.UI.WebControls.Literal
       {
       }
   }
   

4. Add a reference to the CustomControls project to your website.

5. Add the assembly registration to the top of your aspx page:

   <%@ Register assembly="CustomControls" namespace="CustomControls" tagprefix="web" %>

6. Add a new instance of the control to your page:

   <web:Literal ID="Literal1" runat="server" Text="test" />

In App_Code Method

1. Create a new Empty Website (ASP.Net).

2. Add a new Class to the App_Code folder Literal2 (I'm using C# so my file is named Literal2.cs). Below is my super basic code, that I believe should match the code described in the question. I called it 2 so that you can use this in conjunction with the method described above without getting compile errors

   namespace CustomControls
   {
       public class Literal2 : System.Web.UI.WebControls.Literal
       {
       }
   }
   

3. Register the assembly/namespace for app_code in your aspx page by adding the following line to the top

   <%@ Register Namespace="CustomControls" Assembly="__code" tagprefix="web" %>

4. Add an instance of the new control to your page:

   <web:Literal2 ID="literal2" runat="server" Text="test2" />

I tested this using visual studio and it all worked fine for me.

Answer 2

You can also register your control in web.config if you would like to use it on other pages

<pages>
        <controls>
          <add tagPrefix="asp" namespace="System.Web.UI" assembly="System.Web.Extensions, Version=3.5.0.0, Culture=neutral, PublicKeyToken=31BF3856AD364E35"/>
          <add tagPrefix="asp" namespace="System.Web.UI.WebControls" assembly="System.Web.Extensions, Version=3.5.0.0, Culture=neutral, PublicKeyToken=31BF3856AD364E35"/>
          <add tagPrefix="web" namespace="MyProject.CustomControls" assembly="MyProject" />
        </controls>
      </pages>

For web site this will work

<add tagPrefix ="web" namespace="ASP.App_Code.CustomControls" />