Knowledge Base

ASP.NET server controls overview

Article ID: 306459

Article Last Modified on 5/17/2007

APPLIES TO

Microsoft ASP.NET 1.1
Microsoft ASP.NET 1.0

This article was previously published under Q306459

This article refers to the following Microsoft .NET Framework Class Library namespaces:

System.Web.UI.HtmlControls.HtmlControl
System.Web.UI.WebControls.WebControl

SUMMARY

This article provides an introduction to the ASP.NET server controls.

For additional ASP.NET overviews, refer to the following Microsoft Knowledge Base article:

305140 INFO: ASP.NET Roadmap

MORE INFORMATION

The ASP.NET page framework includes a number of built-in server controls that are designed to provide a more structured programming model for the Web. These controls provide the following features:

Automatic state management.
Simple access to object values without having to use the Request object.
Ability to react to events in server-side code to create applications that are better structured.
Common approach to building user interfaces for Web pages.
Output is automatically customized based on the capabilities of the browser.

In addition to the built-in controls, the ASP.NET page framework also provides the ability to create user controls and custom controls. User controls and custom controls can enhance and extend existing controls to build a much richer user interface.

HTML Server Controls

The HTML server controls are Hypertext Markup Language (HTML) elements that include a runat=server attribute. The HTML server controls have the same HTML output and the same properties as their corresponding HTML tags. In addition, HTML server controls provide automatic state management and server-side events. HTML server controls offer the following advantages:

The HTML server controls map one to one with their corresponding HTML tags.
When the ASP.NET application is compiled, the HTML server controls with the runat=server attribute are compiled into the assembly.
Most controls include an OnServerEvent for the most commonly used event for the control. For example, the <input type=button> control has an OnServerClick event.
The HTML tags that are not implemented as specific HTML server controls can still be used on the server side; however, they are added to the assembly as HtmlGenericControl.
When the ASP.NET page is reposted, the HTML server controls keep their values.

The System.Web.UI.HtmlControls.HtmlControl base class contains all of the common properties. HTML server controls derive from this class.

To use an HTML server control, use the following syntax (which uses the HtmlInputText control as an example):

<input type="text" value="hello world" runat=server />

For more information about individual HTML server controls that are available in ASP.NET, refer to the following Microsoft Web sites:

back to the top

Web Server Controls

Web controls are very similar to the HTML server controls such as Button, TextBox, and Hyperlink, except that Web controls have a standardized set of property names. Web server controls offer the following advantages:

Make it easier for manufacturers and developers to build tools or applications that automatically generate the user interface.
Simplify the process of creating interactive Web forms, which requires less knowledge of how HTML controls work and make the task of using them less prone to errors.

The System.Web.UI.WebControls.WebControl base class contains all of the common properties. Most of the Web server controls derive from this class.

To use a Web server control, use the following syntax (which uses the TextBox control as an example):

<asp:textbox text="hello world" runat=server />

Web server controls can be divided into four categories:

Basic Web Controls
Validation Controls
List Controls
Rich Controls

Basic Web Controls

Basic Web controls provide the same functionality as their HTML server control counterparts. However, basic Web control include additional methods, events, and properties against which you can program.

For more information about individual Web controls that are available in ASP.NET, refer to the following Microsoft Web sites:

Validation Controls

Validation controls are used to validate the values that are entered into other controls of the page. Validation controls perform client-side validation, server-side validation, or both, depending on the capabilities of the browser in which the page is displayed. Validation controls offer the following advantages:

You can associate one or more validation controls with each control that you want to validate.
The validation is performed when the page form is submitted.
You can specify programmatically whether validation should occur, which is useful if you want to provide a cancel button so that the user can exit without having to fill valid data in all of the fields.
The validation controls automatically detect whether validation should be performed on the client side or the server side.

Note A client-side validation catches errors before a postback operation is complete. Therefore, if you have combinations of client-side and server-side validation controls on a single page, the server-side validation will be preempted if a client-side validation fails.

For more information about individual validation controls that are available in ASP.NET, refer to the following Microsoft Web sites:

RequiredFieldValidator Control
http://msdn.microsoft.com/library/default.asp?url=/library/en-us/cpgenref/html/cpconrequiredfieldvalidatorcontrol.asp

RangeValidator Control
http://msdn.microsoft.com/library/default.asp?url=/library/en-us/cpgenref/html/cpconrangevalidatorcontrol.asp

CompareValidator Control
http://msdn.microsoft.com/library/default.asp?url=/library/en-us/cpgenref/html/cpconcomparevalidatorcontrol.asp

RegularExpressionValidator Control
http://msdn.microsoft.com/library/default.asp?url=/library/en-us/cpgenref/html/cpconregularexpressionvalidatorcontrol.asp

CustomValidator Control
http://msdn.microsoft.com/library/default.asp?url=/library/en-us/cpgenref/html/cpconcustomvalidatorcontrol.asp

ValidationSummary Control
http://msdn.microsoft.com/library/default.asp?url=/library/en-us/cpgenref/html/cpconvalidationsummarycontrol.asp

List Controls

List controls are special Web server controls that support binding to collections. You can use list controls to display rows of data in a customized, templated format. All list controls expose DataSource and DataMember properties, which are used to bind to collections.

List controls can bind only to collections that support the IEnumerable, ICollection, or IListSource interfaces. For example, a Microsoft Visual C# .NET sample page appears as follows:

<%@ Page Language="C#" %>
<script runat="server">
Public void Page_Load()
{
    String[] myStringArray = new String[] {"one","two","three"};
    rptr.DataSource = myStringArray;
    rptr.DataBind();
}
</script>
<html>
<body>
<asp:repeater id=rptr runat="server">
    <itemtemplate><%# Container.DataItem %><br></itemtemplate>
</asp:repeater>
</body>
</html>

A Microsoft Visual Basic .NET sample page appears as follows:

<%@ Page Language="vb" %>
<script runat="server">
public sub Page_Load()
    Dim myStringArray as String()
    myStringArray = new String() {"one","two","three"}
    rptr.DataSource = myStringArray
    rptr.DataBind()
end sub
</script>
<html>
<body>
    <asp:repeater id=rptr runat="server">
        <itemtemplate><%# Container.DataItem %><br></itemtemplate>
    </asp:repeater>
</body>
</html>

The output appears as follows:

one
two
three

For more information about individual list controls that are available in ASP.NET, refer to the following Microsoft Web sites:

ListBox Web Server Control
http://msdn.microsoft.com/library/default.asp?url=/library/en-us/cpgenref/html/cpconlistboxwebservercontrol.asp

CheckBoxList Web Server Control
http://msdn.microsoft.com/library/default.asp?url=/library/en-us/cpgenref/html/cpconcheckboxlistwebservercontrol.asp

RadioButtonList Web Server Control
http://msdn.microsoft.com/library/default.asp?url=/library/en-us/cpgenref/html/cpconradiobuttonlistwebservercontrol.asp

Repeater Web Server Control
http://msdn.microsoft.com/library/default.asp?url=/library/en-us/cpgenref/html/cpconrepeaterwebservercontrol.asp

DataList Web Server Control
http://msdn.microsoft.com/library/default.asp?url=/library/en-us/cpgenref/html/cpcondatalistwebservercontrol.asp

DataGrid Web Server Control
http://msdn.microsoft.com/library/default.asp?url=/library/en-us/vbcon/html/vbconDataGridWebControl.asp

DropDownList Web Server Control
http://msdn.microsoft.com/library/default.asp?url=/library/en-us/cpgenref/html/cpcondropdownlistwebservercontrol.asp

Rich Controls

In addition to the preceding controls, the ASP.NET page framework provides a few, task-specific controls called rich controls. Rich controls are built with multiple HTML elements and contain rich functionality. Examples of rich controls are the Calendar control and the AdRotator control.

For more information about individual rich controls that are available in ASP.NET, refer to the following Microsoft Web sites:

AdRotator Web Server Control
http://msdn.microsoft.com/library/default.asp?url=/library/en-us/cpgenref/html/cpconadrotatorwebservercontrol.asp

Calendar Web Server Control
http://msdn.microsoft.com/library/default.asp?url=/library/en-us/cpgenref/html/cpconcalendarwebcontrol.asp

Xml Web Server Control
http://msdn.microsoft.com/library/default.asp?url=/library/en-us/cpgenref/html/gnconxmlwebservercontrol.asp

back to the top

User Controls

Often, you may want to reuse the user interface of your Web Form without having to write any extra code. ASP.NET enables you to do this by converting your Web Forms into user controls. User controls, which have the .ascx file extension, can be used multiple times within a single Web Form.

To convert a Web Form into a user control, follow these steps:

Remove all <html>,<head>, <body> and <form> tags.
If the @ Page directive appears in the page, change it to @ Control.
Include a className attribute in the @ Control directive so that the user control is typed strongly when you instantiate it.
Give the control a descriptive file name, and change the file extension from .aspx to .ascx.

For more information about user controls, refer to the following topic in the Microsoft .NET Framework Software Development Kit (SDK) documentation:

Web Forms User Controls
http://msdn.microsoft.com/library/default.asp?url=/library/en-us/cpguide/html/cpconwebformsusercontrols.asp

back to the top

Custom Controls

In addition to the built-in Web controls, ASP.NET also allows you to create your own custom controls. It may be useful to develop custom controls if you are faced with one of these scenarios:

You need to combine the functionality of two or more built-in Web controls.
You need to extend the functionality of a built-in control.
You need a control that is completely different than any of the controls that currently exist.

For more information about developing custom controls, refer to the following topics in the .NET Framework SDK documentation:

Developing ASP.NET Server Controls
http://msdn2.microsoft.com/en-us/library/aa719973(vs.71).aspx

Developing Custom Controls: Key Concepts
http://msdn.microsoft.com/library/default.asp?url=/library/en-us/cpguide/html/cpconkeyconceptsinwebformscontroldevelopment.asp

Developing a Composite Control
http://msdn.microsoft.com/library/default.asp?url=/library/en-us/cpguide/html/cpcondevelopingcompositecontrols.asp

back to the top

Keywords: kbarttyperoadmap kbdatabinding kbinfo kbservercontrols kbvalidation kbwebforms KB306459

Microsoft KB Archive/306459

Contents

ASP.NET server controls overview

SUMMARY

MORE INFORMATION

HTML Server Controls

Web Server Controls

Basic Web Controls

Validation Controls

List Controls

Rich Controls

User Controls

Custom Controls