Styling the ASP.NET login controls

Note: this post is over a year old, it's very likely completely outdated and should probably not be used as reference any more. You have been warned. :-)

Today, I was handed a piece of HTML which featured a login form. My assignment: create this in Umbraco, using the default Membership provider.

This could be considered as an "Umbraco tip of the week", however this applies to ASP.NET webforms in general as well.

I thought about applying styles and maybe some Javascript hacking to make the login form look exactly like the design. Then, after some searching on the internet, I found out that it is actually extremely easy to apply any layout to your login form.

I started out with this:

<form runat="server">
<asp:Login id="Login1" runat="server" />
</form>

The designer had made some prettier input boxes with background images and the "Login" button was actually style link.

You can actually use something called a LayoutTemplate from
within your login control.

The easiest way to do this is to:

  • Open up your master page in Visual Studio
  • Go to the designer view Right-click the Login control and choose "Convert to template"
  • Start customizing the HTML

However, if you want to do this manually (and who doesn't love some manual tinkering), you have to keep in mind that you need to put at least three controls in your login control:

  • An asp:TextBox control* with an ID of: UserName
  • An asp:TextBox control* with an ID of: Password
  • Either an asp:Button an asp:ImageButton or an asp:LinkButton control with a property: CommandName="Login"

* When I say a TextBox control, I actually mean a web control that implements ITextControl.

If you want to show an error when the login fails, add an asp:Literal with an ID of: FailureText

In the end, you'll end up with a piece of code that looks a bit like this (custom styling removed to keep this nice and short):

<form runat="server">
<asp:Login id="Login1" runat="server">
<LayoutTemplate>
<asp:TextBox ID="UserName" runat="server"></asp:TextBox>
<asp:TextBox ID="Password" runat="server" TextMode="Password"></asp:TextBox>
<asp:LinkButton ID="submitLoginBtn" CommandName="Login" runat="server">Login</asp:LinkButton>
<asp:Literal ID="FailureText" runat="server" EnableViewState="False"></asp:Literal>
</LayoutTemplate>
</asp:Login>
</form>

Update: As Dirk and Jan point out, this method will still produce a table surrounding the login controls. This is only a wrapper though, no table element go between the input tags, not to worry.

Dirk is actually working on getting the ASP.NET 2.0 CSS Friendly Control Adapters to work with Umbraco. Mind you, these adapters are available for .NET 2.0 only.

I personally set-up all my Umbraco installations with the .NET 3.5 config, so this method would not work for me. I don't view this as a big problem, I just style the wrapping table and ignore it.

Sebastiaan Janssen

Dutch guy living in (and loving) Copenhagen, working at Umbraco HQ. Lifehacker, skeptic, music lover, cyclist, developer.

 

4 comments on this article

Avatar for Peter Gregory Peter Gregory | September 7 2009 01:31
Hi Sebastiaan

We are using the control adapters with our Umbraco projects running under 3.5 and have no problems. Just one thing to be aware of tho is that they rewrite the checkbox lists and radio button lists from being tables to uls (a good thing) but that means in the admin the checkbox lists and radio button lists get bullet points.

Just need to disable that control adapter to stop it from happening or create a new adapter and a control that inherits from those controls.

Hope it works out for you.

Avatar for Jan Skovgaard Jan Skovgaard | November 2 2009 19:40
Hi Peter

Would you care to let us know how you got the control adapters working with Umbraco? Eventually in a blog-post if possible?

Cheers!

Avatar for Gaurav Kumar Gaurav Kumar | January 6 2012 08:42
Hi,
Your article are really awesome.actually i was in search for some good articles on Login Control in ASP.Net and finally i got one.
The most important is the simplicity which will be very helpful for the beginners.
I had found another nice post over the internet which have also a wonderful explanation on login control in asp.net, for more details of that post you may check out this link...

http://www.mindstick.com/Articles/1bd75404-424e-4c84-ab55-28742117d6ad/?Login%20Control%20in%20ASP.Net

Thanks Everyone!!

Avatar for Tim Gaunt Tim Gaunt | September 26 2012 10:07
@Dirk and @Jan, if you don't want the surrounding table you can add: RenderOuterTable="False" to the asp:login e.g.:

<asp:Login runat="server" RenderOuterTable="False">

Hope the helps.

Tim