ASP.NET 2.0 Control Reference


AccessDataSource

 
<asp:AccessDataSource id="id" Runat="Server"
  DataFile="path"
  DataSourceMode="DataSet|DataReader
  DeleteCommand="string"
  DeleteCommandType="Text|StoredProcedure"
  FilterExpression="name='{0}'"
  InsertCommand="string"
  InsertCommandType="Text|StoredProcedure"  
  SelectCommand="string"
  SelectCommandType="Text|StoredProcedure"
  UpdateCommand="string"
  UpdateCommandType="Text|StoredProcedure"
  
    OnDeleted="subprogram"
    OnDeleting="subprogram"
    OnFiltering="subprogram"
    OnInserted="subprogram"
    OnInserting="subprogram"
    OnSelected="subprogram"
    OnSelecting="subprogram"
    OnUpdated="subprogram"
    OnUpdating="subprogram"
>

  <DeleteParameters>
    <asp:ControlParameter Name="name" ControlId="id" PropertyName="name"/>
    <asp:FormParameter Name="name" FormField="id"/>
    <asp:QueryParameter Name="name" QueryStringField="name"/>
  </DeleteParameters>
  
  <FilterParameters>
    <asp:ControlParameter Name="name" ControlId="id" PropertyName="name"/>
    <asp:FormParameter Name="name" FormField="id"/>
    <asp:QueryParameter Name="name" QueryStringField="name"/>
  </FilterParameters>
  
  <InsertParameters>
    <asp:ControlParameter Name="name" ControlId="id" PropertyName="name"/>
    <asp:FormParameter Name="name" FormField="id"/>
    <asp:QueryParameter Name="name" QueryStringField="name"/>
    <asp:FormParameter Name="name" FormField="id"/>
  </InsertParameters>
  
  <SelectParameters>
    <asp:ControlParameter Name="name" ControlId="id" PropertyName="name"/>
    <asp:FormParameter Name="name" FormField="id"/>
    <asp:QueryParameter Name="name" QueryStringField="name"/>
  </SelectParameters>

  <UpdateParameters>
    <asp:ControlParameter Name="name" ControlId="id" PropertyName="name"/>
    <asp:FormParameter Name="name" FormField="id"/>
    <asp:QueryParameter Name="name" QueryStringField="name"/>
  </UpdateParameters>
  
</asp:AccessDataSource>

Properties

Name Description
DataFile Gets or sets the location of the Microsoft Access .mdb file.
DataSourceMode Gets or sets the data retrieval mode that the AccessDataSource control uses to fetch data.
Mode Description
DataSet Retrieves data from the underlying data storage as an DataSet.
DataReader Retrieves data from the underlying data storage as an DataReader.
DeleteCommand Gets or sets the SQL string that the AccessDataSource control uses to delete data from the underlying database.
DeleteCommandType Gets or sets a value indicating whether the text in the DeleteCommand property is an SQL statement or the name of a stored procedure.
Type Description
StoredProcedure The text contained in a corresponding text property is the name of a stored procedure.
Text (default) The text contained in a corresponding text property is a SQL query or command.
DeleteParameters Gets the parameters collection that contains the parameters that are used by the DeleteCommand property of the AccessDataSource control.
EnableCaching Gets or sets a value indicating whether the AccessDataSource control has data caching enabled.
FilterExpression Gets or sets a filtering expression that is applied when the Select method is called.
FilterParameters Gets a collection of parameters that are associated with any parameter placeholders that are in the FilterExpression string.
ID Gets or sets the programmatic identifier assigned to the server control.
InsertCommand Gets or sets the SQL string that the AccessDataSource control uses to insert data into the underlying database.
InsertCommandType Gets or sets a value indicating whether the text in the InsertCommand property is an SQL statement or the name of a stored procedure.
Type Description
StoredProcedure The text contained in a corresponding text property is the name of a stored procedure.
Text (default) The text contained in a corresponding text property is a SQL query or command.
InsertParameters Gets the parameters collection that contains the parameters that are used by the InsertCommand property of the AccessDataSource object.
<InsertParameters>
  <asp:FormParameter Name="name" FormField="field"/>
</InsertParameters>
SelectCommand Gets or sets the SQL string that the SqlDataSource control uses to retrieve data from the underlying database.
SelectCommandType Gets or sets a value indicating whether the text in the SelectCommand property is an SQL query or the name of a stored procedure.
Type Description
StoredProcedure The text contained in a corresponding text property is the name of a stored procedure.
Text (default) The text contained in a corresponding text property is a SQL query or command.
SelectParameters Gets the parameters collection that contains the parameters that are used by the SelectCommand property of the AccessDataSource object.
UpdateCommand Gets or sets the SQL string that the SqlDataSource control uses to update data in the underlying database.
UpdateCommandType Gets or sets a value indicating whether the text in the UpdateCommand property is an SQL statement or the name of a stored procedure.
Type Description
StoredProcedure The text contained in a corresponding text property is the name of a stored procedure.
Text (default) The text contained in a corresponding text property is a SQL query or command.
UpdateParameters Gets the parameters collection that contains the parameters that are used by the UpdateCommand property of the AccessDataSource control.

Methods

Name Description
Delete Performs a delete operation using the DeleteCommand SQL string and any parameters that are in the DeleteParameters collection.
Insert Performs an insert operation using the InsertCommand SQL string and any parameters that are in the InsertParameters collection.
Select Retrieves data from the underlying database using the SelectCommand SQL string and any parameters that are in the SelectParameters collection.
Update Performs an update operation using the UpdateCommand SQL string and any parameters that are in the UpdateParameters collection.

Events

Name Description
Deleted Occurs when a delete operation has completed.
args As SqlDataSourceStatusEventArgs
Property Description
.AffectedRows Gets the number of rows affected by a database operation.
.Command Gets the database command submitted to the database.
Deleting Occurs before a delete operation.
args As SqlDataSourceCommandEventArgs
Property Description
.Cancel Gets or sets a value indicating whether the event should be canceled.
.Command Gets the pending database command.
Filtering Occurs before a filter operation.
args As SqlDataSourceFilteringEventArgs
Property Description
.Cancel Gets or sets a value indicating whether the event should be canceled.
.ParameterValues Gets a dictionary object that provides access to the Parameter objects of the SqlDataSource class.
Inserted Occurs when an insert operation has completed.
args As SqlDataSourceStatusEventArgs
Property Description
.AffectedRows Gets the number of rows affected by a database operation.
.Command Gets the database command submitted to the database.
Inserting Occurs before an insert operation.
args As SqlDataSourceCommandEventArgs
Property Description
.Cancel Gets or sets a value indicating whether the event should be canceled.
.Command Gets the pending database command.
Selected Occurs when a data retrieval operation has completed.
args As SqlDataSourceStatusEventArgs
Property Description
.AffectedRows Gets the number of rows affected by a database operation.
.Command Gets the database command submitted to the database.
Selecting Occurs before a data retrieval operation.
args As SqlDataSourceSelectingEventArgs
Property Description
.Arguments Gets the DataSourceSelectArguments object passed to the Select method.
.Cancel Gets or sets a value indicating whether the event should be canceled.
.Command Gets the pending database command.
Updated Occurs when an update operation has completed.
args As SqlDataSourceStatusEventArgs
Property Description
.AffectedRows Gets the number of rows affected by a database operation.
.Command Gets the database command submitted to the database.
Updating Occurs before an update operation.
args As SqlDataSourceCommandEventArgs
Property Description
.Cancel Gets or sets a value indicating whether the event should be canceled.
.Command Gets the pending database command.

Top

BoundField

 
<asp:BoundField id="id" Runat="Server"
  ApplyFormatInEditMode="False|True"
  ConvertEmptyStringToNull="False|True"
  DataField="field"
  DataFormatString="{string}"
  FooterText="string"
  HeaderImageUrl="url"
  HeaderText="string"
  HtmlEncode="False|True"
  InsertVisible="False|True"
  NullDisplayText="string"
  ReadOnly="False|True"
  ShowHeader="False|True"
  SortExpression="field"
  
    FooterStyle-property="value"...
    HeaderStyle-property="value"...
    ItemStyle-property="value"...
    property="value"...	
/>

Properties

Name Description
ApplyFormatInEditMode Gets or sets a value indicating whether the formatting string specified by the DataFormatString property is applied to field values when the data-bound control that contains the BoundField object is in edit mode.
ConvertEmptyStringToNull Gets or sets a value indicating whether empty string values (“”) are automatically converted to null values when the data field is updated in the data source.
DataField Gets or sets the name of the data field to bind to the BoundField object.
DataFormatString Gets or sets the string that specifies the display format for the value of the field.
FooterStyle Gets or sets the style of the footer of the data control field.
FooterText Gets or sets the text that is displayed in the footer item of a data control field.
HeaderImageUrl Gets or sets the URL of an image that is displayed in the header item of a data control field.
HeaderStyle Gets or sets the style of the header of the data control field.
HeaderText Gets or sets the text that is displayed in the header of a data control.
HtmlEncode Gets or sets a value indicating whether field values are HTML-encoded before they are displayed in a BoundField object.
InsertVisible Gets a value indicating whether the DataControlField object is visible when its parent data-bound control is in insert mode.
ItemStyle Gets the style of any text-based content displayed by a data control field.
NullDisplayText Gets or sets the caption displayed for a field when the field’s value is null.
ReadOnly Gets or sets a value indicating whether the value of the field can be modified in edit mode.
ShowHeader Gets or sets a value indicating whether the header item of a data control field is rendered.
SortExpression Gets or sets a sort expression that is used by a data source control to sort data.
Visible Gets or sets a value indicating whether a data control field is rendered.

Top

BulletedList

 
<asp:BulletedList id="id" Runat="Server"
  BulletImageUrl="url"
  BulletStyle="Circle|CustomImage|Disc|LowerAlpha|LowerRoman|
               Numbered|Square|UpperAlpha|UpperRoman|NotSet"
  CausesValidation="True|False"
  DataSourceID="id"
  DataTextField="field"
  DataTextFormatString="{string}"
  DataValueField="field"
  DisplayMode="HyperLink|LinkButton|Text"
  FirstBulletNumber="n"
  Target="_blank|_self|_search|_top|_parent|framename"
  ValidationGroup="name"

    property="value"...

    OnClick="subprogram"
>
	
  <asp:ListItem
    Selected="True|False"
    Text="label"
    Value="value"
  />
  ...

</asp:BulletedList>

Properties

Name Description
BulletImageUrl Gets or sets the path to an image to display for each bullet in a BulletedList control.
BulletStyle Gets or sets the bullet style for the BulletedList control.
Type Description
Circle The bullet style is an empty circle shape.
CustomImage The bullet style is a custom image.
Disc The bullet style is a filled circle shape.
LowerAlpha The bullet style is a lowercase letter (a, b, c, ...).
LowerRoman The bullet style is a lowercase Roman numeral (i, ii, iii, ...).
NotSet The bullet style is not set. The browser that renders the BulletedList control will determine the bullet style to display.
Numbered The bullet style is a number (1, 2, 3, ...).
Square The bullet style is a filled square shape.
UpperAlpha The bullet style is an uppercase letter (A, B, C, ...).
UpperRoman The bullet style is an uppercase Roman numeral (I, II, III, ...).
CausesValidation Gets or sets a value indicating whether validation is performed when an item in the list is clicked
DataSourceID Gets or sets the ID of the control from which the data-bound control retrieves its list of data items.
DataTextField Gets or sets the field of the data source that provides the text content of the list items.
DataTextFormatString Gets or sets the formatting string used to control how data bound to the list control is displayed.
DataValueField Gets or sets the field of the data source that provides the value of each list item.
DisplayMode Gets or sets the display mode of the list content in a BulletedList control.
Mode Description
HyperLink Displays the list item content as hyperlinks.
LinkButton Displays the list item content as link buttons.
Text Displays the list item content as text.
FirstBulletNumber Gets or sets the value that starts the numbering of list items in an ordered BulletedList control.
ID Gets or sets the programmatic identifier assigned to the server control.
Items Gets the collection of ListItem objects in the list control.
Property Description
.Count Gets the number of ListItem objects in the collection.
(index) Gets a ListItem object at a specified index in the collection.
Property Description
.Text Gets or sets the text displayed in a list control for the item represented by the ListItem.
.Value Gets or sets the value associated with the ListItem.
Method Description
.Clear() Clear all items from a ListItem collection.
.FindByText("text")
Searches the collection for a ListItem with a Text property that contains the specified value.
.FindByValue("value")
Searches the collection for a ListItem with a Value property that contains the specified value.
.RemoveAt(index) Remove an item from the ListItem at the index location in the collection.
.Add(New ListItem("text","value"))
Add a new ListItem next in order in the collection.
.Insert(index, New ListItem("text","value"))
Add a new ListItem at the index location in the collection.
Target Gets or sets the target window or frame in which to display the Web page content that is linked to when a hyperlink in a BulletedList control is clicked.
Value Description
_blank Renders the content in a new window without frames.
_parent Renders the content in the immediate frameset parent.
_search Renders the content in the search pane.
_self Renders the content in the frame with focus.
_top Renders the content in the full window without frames.
framename Renders the content in a named frame in a frameset.
ValidationGroup Gets or sets the group of controls for which the control that is derived from the ListControl class causes validation when it posts back to the server.

Events, Arguments, and Properties

Name Description
Click Occurs when a link button in a BulletedList control is clicked.
args As BulletedListEventArgs
Property Description
args.Index Gets the index of the list item in a BulletedList control that raised the event. Use to reference properties of the BulletedList ListItem.

Dim item As ListItem
item = BulletedList.Items(args.Index)
Property Description
item.Text Gets or sets the text displayed in a list control for the item represented by the ListItem.
item.Value Gets or sets the value associated with the ListItem.

Top

Button

 
<asp:Button id="id" Runat="Server"
  CausesValidation="True|False"
  CommandArgument="argument"
  CommandName="command"
  OnClientClick="client subprogram"
  PostBackUrl="url"
  Text="string"
  ValidationGroup="name"
    
    property="value"...
    
    OnClick="subprogram"
    OnCommand="subprogram"
/>

Properties

Name Description
CausesValidation Gets or sets a value indicating whether validation is performed when the Button control is clicked.
CommandArgument Gets or sets an optional parameter passed to the Command event along with the associated CommandName.
CommandName Gets or sets the command name associated with the Button control that is passed to the Command event.
ID Gets or sets the programmatic identifier assigned to the server control.
OnClientClick Gets or sets the client-side script that executes when a Button control’s Click event is raised.
PostBackUrl Gets or sets the URL of the page to post to from the current page when the Button control is clicked.
Text Gets or sets the text caption displayed in the Button control.
ValidationGroup Gets or sets the group of controls for which the Button control causes validation when it posts back to the server.

Events and Arguments

Name Description
Click Occurs when the Button control is clicked.
args As EventArgs
Command Occurs when the Button control is clicked.
args As CommandEventArgs
Property Description
args.CommandName Gets the value associated the button's CommandName.
args.CommandArgument Gets the value associated the button's CommandArgument.

Top

ButtonField

 
<asp:ButtonField id="id" Runat="Server"
  ButtonType="Button|Image|Link"
  CausesValidation="True|False"
  CommandName="string"
  DataTextField="field"
  DataTextFormatString="{string}"
  FooterText="string"
  HeaderImageUrl="url"
  HeaderText="string"
  ImageUrl="url"
  InsertVisible="False|True"
  ShowHeader="False|True"
  SortExpression="field"
  Text="string"
  ValidationGroup="name"
  
    FooterStyle-property="value"...
    HeaderStyle-property="value"...
    ItemStyle-property="value"...
    property="value"...
/>

Properties

Name Description
ButtonType Gets or sets the button type to display in the button field.
Type Description
Button A button control.
Image A button with an image.
Link A link.
CausesValidation Gets or sets a value indicating whether validation is performed when a button in a ButtonFieldBase object is clicked.
CommandName Gets or sets a string that represents the action to perform when a button in a ButtonField object is clicked.
DataTextField Gets or sets the name of the data field for which the value is bound to the Text property of the Button control that is rendered by the ButtonField object.
DataTextFormatString Gets or sets the string that specifies the display format for the value of the field.
FooterStyle Gets or sets the style of the footer of the data control field.
FooterText Gets or sets the text that is displayed in the footer item of a data control field.
HeaderImageUrl Gets or sets the URL of an image that is displayed in the header item of a data control field.
HeaderStyle Gets or sets the style of the header of the data control field.
HeaderText Gets or sets the text that is displayed in the header item of a data control field.
ImageUrl Gets or sets the image to display for each button in the ButtonField object.
InsertVisible Gets a value indicating whether the DataControlField object is visible when its parent data-bound control is in insert mode.
ItemStyle Gets the style of any text-based content displayed by a data control field.
ShowHeader Gets or sets a value indicating whether the header section is displayed in a ButtonFieldBase object.
SortExpression Gets or sets a sort expression that is used by a data source control to sort data.
Text Gets or sets the static caption that is displayed for each button in the ButtonField object.
ValidationGroup Gets or sets the name of the group of validation controls to validate when a button in a ButtonFieldBase object is clicked.
Visible Gets or sets a value indicating whether a data control field is rendered.

Top

Calendar

 
<asp:Calendar id="id" Runat="Server"
  Caption="string"
  CaptionAlign="Top|Bottom|Left|Right|NotSet"
  CellPadding="n"
  CellSpacing="n"
  DayNameFormat=FirstLetter|FirstTwoLetters|Full|Short|Shortest
  FirstDayOfWeek=Default|Sunday|Monday|Tuesday|Wednesday|Thursday|
                 Friday|Saturday
  NextMonthText="string"
  NextPrevFormat="CustomText|FullMonth|ShortMonth
  PrevMonthText="string"
  SelectedDate="Date/Time"
  SelectionMode="Day|DayWeek|DayWeekMonth|None"
  SelectMonthText="string"
  SelectWeekText="string"
  ShowDayHeader="True|False"
  ShowGridLines="True|False"
  ShowNextPrevMonth="True|False"
  ShowTitle="True|False"
  TitleFormat="Month|MonthYear"
  TodaysDate="Date/Time"
  VisibleDate="Date/Time"
    
    DayHeaderStyle-property="value"...
    DayStyle-property="value"...
    NextPrevStyle-property="value"...
    OtherMonthDayStyle-property="value"...
    SelectedDayStyle-property="value"...
    TitleStyle-property="value"...
    TodayDayStyle-property="value"...
    WeekendDayStyle-property="value"...
    property="value"...
    
    OnDayRender="subprogram"
    OnSelectionChanged="subprogram"
    OnVisibleMonthChanged="subprogram"
/>

Properties

Name Description
Caption Gets or sets the text to render in an HTML caption element in the control.
CaptionAlign Gets or sets the horizontal or vertical position of the HTML caption element in a control.
Value Description
Bottom The caption element is aligned with the bottom of the table.
Left The caption element is aligned with the left side of the table.
NotSet The caption alignment is not set. The browser that renders the caption determines where to align the caption.
Right The caption element is aligned with the right side of the table.
Top The caption element is aligned with the top of the table.
CellPadding Gets or sets the amount of space between the contents of a cell and the cell’s border.
CellSpacing Gets or sets the amount of space between cells.
DayHeaderStyle Gets the style properties for the section that displays the day of the week.
DayNameFormat Gets or sets the name format for days of the week.
Value Description
FirstLetter The days of the week displayed with just the first letter. For example, M represents Monday.
FirstTwoLetters The days of the week displayed with just the first two letters. For example, Mo represents Monday.
Full The days of the week displayed in full format. For example, Monday.
Short The days of the week displayed in abbreviated format. For example, Mon represents Monday.
Shortest The days of the week displayed in the shortest abbreviation format possible for the current culture.
DayStyle Gets the style properties for the days in the displayed month.
FirstDayOfWeek Gets or sets the day of the week to display in the first day column of the Calendar control.
Value Description
Default Indicates that the first day of the week is specified by the system settings.
Sunday Indicates that the first day of the week is Sunday.
Monday Indicates that the first day of the week is Monday.
Tuesday Indicates that the first day of the week is Tuesday.
Wednesday Indicates that the first day of the week is Wednesday.
Thursday Indicates that the first day of the week is Thursday.
Friday Indicates that the first day of the week is Friday.
Saturday Indicates that the first day of the week is Saturday.
ID Gets or sets the programmatic identifier assigned to the server control.
NextMonthText Gets or sets the text displayed for the next month navigation control. The default value is ">".
NextPrevFormat Gets or sets the format of the next and previous month navigation elements in the title section of the Calendar control.
Value Description
CustomText Custom text format for the month navigation controls on the Calendar.
FullMonth Full month name format for the month navigation controls on the Calendar. For example, "January".
ShortMonth Abbreviated month name format for the month navigation controls on the Calendar. For example, "Jan".
NextPrevStyle Gets the style properties for the next and previous month navigation elements.
OtherMonthDayStyle Gets the style properties for the days on the Calendar control that are not in the displayed month.
PrevMonthText Gets or sets the text displayed for the previous month navigation control.
SelectedDate Gets or sets the selected date.
SelectedDates Gets a collection of System.DateTime objects that represent the selected dates on the Calendar control.
SelectedDayStyle Gets the style properties for selected dates.
SelectionMode Gets or sets the date selection mode on the Calendar control that specifies whether the user can select a single day, a week, or an entire month.
Mode Description
Day A single date can be selected on the Calendar control.
DayWeek A single date or entire week can be selected on the Calendar control.
DayWeekMonth A single date, week, or entire month can be selected on the Calendar control.
None No dates can be selected on the Calendar control.
SelectMonthText Gets or sets the text displayed for the month selection element in the selector column.
SelectorStyle Gets the style properties for the week and month selector column.
SelectWeekText Gets or sets the text displayed for the week selection element in the selector column.
ShowDayHeader Gets or sets a value indicating whether the heading for the days of the week is displayed.
ShowGridLines Gets or sets a value indicating whether the days on the Calendar control are separated with gridlines.
ShowNextPrevMonth Gets or sets a value indicating whether the Calendar control displays the next and previous month navigation elements in the title section.
ShowTitle Gets or sets a value indicating whether the title section is displayed.
TitleFormat Gets or sets the format for the title section.
Value Description
Month Displays the title with the month but not the year.
MonthYear Displays the title with both the month and the year.
TitleStyle Gets the style properties of the title heading for the Calendar control.
TodayDayStyle Gets the style properties for today's date on the Calendar control.
TodaysDate Gets or sets the value for today's date.
VisibleDate Gets or sets the date that specifies the month to display on the Calendar control.
WeekendDayStyle Gets the style properties for the weekend dates on the Calendar control.

Events, Arguments, and Properties

Name Description
DayRender Occurs when each day is created in the control hierarchy for the Calendar control.
args As DayRenderEventArgs
Property Description
.Cell Gets a reference to the table cell within which the day is rendered.
.Day Gets the CalendarDay object for the day rendered.
Property Description
.Date Gets the date represented by the CalendarDay object.
.DayNumberText Gets the string equivalent of the day number for the date represented by an instance of the CalendarDay class.
.IsOtherMonth Gets a value that indicates whether the date represented by an instance of this class is in a month other than the month displayed in the Calendar control.
.IsSelectable Gets or sets a value that indicates whether the date represented by an instance of this class can be selected in the Calendar control.
.IsSelected Gets a value that indicates whether the date represented by an instance of this class is selected in the Calendar control.
.IsToday Gets a value that indicates whether the date represented by an instance of this class is the same date specified by the TodaysDate property of the Calendar control.
.IsWeekend Gets a value that indicates whether the date represented by an instance of this class is a either Saturday or Sunday.
SelectionChanged Occurs when the user selects a day, a week, or an entire month by clicking the date selector controls.
args As EventArgs
Property Description
Calendar.SelectedDate Gets the Date/Time for the day selected in the Calendar.
VisibleMonthChanged Occurs when the user clicks the next or previous month navigation controls on the title heading.
args As MonthChangedEventArgs
Property Description
.NewDate Gets the Date/Time that represents the month currently displayed in the Calendar.
Property Description
.Month Gets the month.
.PreviousDate Gets the DateTime that represents the previous month displayed by the Calendar.
Property Description
.Month Gets the month.

Top

CheckBox

 
<asp:CheckBox id="id" Runat="Server"
  AutoPostBack="True|False"
  CausesValidation="True|False"
  Checked="True|False"
  Text="label"
  TextAlign="Left|Right"
  ValidationGroup="name"

    property="value"......

    OnCheckedChanged="subprogram"
/>

Properties

Name Description
AutoPostBack Gets or sets a value indicating whether the CheckBox state automatically posts back to the server when clicked.
CausesValidation Gets or sets a value indicating whether validation is performed when the CheckBox control is clicked.
Checked Gets or sets a value indicating whether the CheckBox control is checked.
ID Gets or sets the programmatic identifier assigned to the server control.
Text Gets or sets the text label associated with the CheckBox.
TextAlign Gets or sets the alignment of the text label associated with the CheckBox control.
Value Description
Left Text associated with a check box or radio button control appears to the left of the control.
Right Text associated with a check box or radio button control appears to the right of the control.
ValidationGroup Gets or sets the group of controls for which the CheckBox control causes validation when it posts back to the server.

Events, Arguments, and Properties

Name Description
CheckedChanged Occurs when the value of the Checked property changes between posts to the server.
args As EventArgs
Property Description
CheckBox.Checked Gets or sets the Checked property of the CheckBox.
CheckBox.Text Gets or sets the Text property of the CheckBox.

Top

CheckBoxField

 
<asp:CheckBoxField id="id" Runat="Server"
  DataField="field"
  FooterText="string"
  HeaderImageUrl="url"
  HeaderText="string"
  InsertVisible="False|True"
  ReadOnly="False|True"
  ShowHeader="False|True"
  SortExpression="field"
  Text="string"
  
    FooterStyle-property="value"...
    HeaderStyle-property="value"...
    ItemStyle-property="value"...
    property="value"...
/>

Properties

Name Description
DataField Gets or sets the name of the data field to bind to the CheckBoxField object.
FooterStyle Gets or sets the style of the footer of the data control field.
FooterText Gets or sets the text that is displayed in the footer item of a data control field.
HeaderImageUrl Gets or sets the URL of an image that is displayed in the header item of a data control field.
HeaderStyle Gets or sets the style of the header of the data control field.
HeaderText Gets or sets the text that is displayed in the header of a data control.
InsertVisible Gets a value indicating whether the DataControlField object is visible when its parent data-bound control is in insert mode.
ItemStyle Gets the style of any text-based content displayed by a data control field.
ReadOnly Gets or sets a value indicating whether the value of the field can be modified in edit mode.
ShowHeader Gets or sets a value indicating whether the header item of a data control field is rendered.
SortExpression Gets or sets a sort expression that is used by a data source control to sort data.
Text Gets or sets the caption to display next to each check box in a CheckBoxField object.
Visible Gets or sets a value indicating whether a data control field is rendered.

Top

CheckBoxList

 
<asp:CheckBoxList id="id" Runat="Server"
  AutoPostBack="True|False"
  CausesValidation="True|False"
  CellPadding="n"
  CellSpacing="n"
  DataSourceID="id"
  DataTextField="field"
  DataTextFormatString="{string}"
  DataValueField="field"
  RepeatColumns="n"
  RepeatDirection="Horizontal|Vertical"
  RepeatLayout="Flow|Table"
  TextAlign="Left|Right"  
    
    property="value"...
    
    OnSelectedIndexChanged="subprogram"
>
	
  <asp:ListItem
    Selected="False|True"
    Text="string"
    Value="value"
  />
  ...
	
</asp:CheckBoxList>

Properties

Name Description
AutoPostBack Gets or sets a value indicating whether a postback to the server automatically occurs when the user changes the list selection.
CausesValidation Gets or sets a value indicating whether validation is performed when a control that is derived from the ListControl class is clicked.
CellPadding Gets or sets the distance (in pixels) between the border and contents of the cell.
CellSpacing Gets or sets the distance (in pixels) between cells.
DataSourceID Gets or sets the ID of the control from which the data-bound control retrieves its list of data items.
DataTextField Gets or sets the field of the data source that provides the text content of the list items.
DataTextFormatString Gets or sets the formatting string used to control how data bound to the list control is displayed.
DataValueField Gets or sets the field of the data source that provides the value of each list item.
ID Gets or sets the programmatic identifier assigned to the server control.
Items Gets the collection of ListItems in the list control.
Property Description
.Count Gets the number of ListItem objects in the collection.
(index) Gets a ListItem object at a specified index in the collection.
Property Description
.Selected Gets or sets whether the ListItem is selected.
.Text Gets or sets the text displayed in the ListItem.
.Value Gets or sets the value associated with the ListItem.
Method Description
.Clear() Clear all items from a ListItem collection.
.FindByText("text")
Searches the collection for a ListItem with a Text property that contains the specified value.
.FindByValue("value")
Searches the collection for a ListItem with a Value property that contains the specified value.
.RemoveAt(index) Remove an item from the ListItem at the index location in the collection.
.Add(New ListItem("text","value"))
Add a new ListItem next in order in the collection.
.Insert(index, New ListItem("text","value"))
Add a new ListItem at the index location in the collection.
RepeatColumns Gets or sets the number of columns to display in the CheckBoxList control.
RepeatDirection Gets or sets a value that indicates whether the control displays vertically or horizontally.
Value Description
Horizontal Items of a list are displayed horizontally in rows from left to right, then top to bottom, until all items are rendered.
Vertical Items of a list are displayed vertically in columns from top to bottom, and then left to right, until all items are rendered.
RepeatLayout Gets or sets the layout of the check boxes.
Value Description
Flow Items are displayed without a table structure.
Table Items are displayed in a table.
SelectedIndex Gets or sets the lowest ordinal index of the selected items in the list.
SelectedItem Gets the selected item with the lowest index in the list control.
SelectedValue Gets the value of the selected item in the list control, or selects the item in the list control that contains the specified value.
Text Gets or sets the SelectedValue property of the ListControl control.
TextAlign Gets or sets the text alignment for the check boxes within the group.
Value Description
Left Text associated with a check box or radio button control appears to the left of the control.
Right Text associated with a check box or radio button control appears to the right of the control.
ValidationGroup Gets or sets the group of controls for which the control that is derived from the ListControl class causes validation when it posts back to the server.

Methods

Name Description
ClearSelection Clears out the list selection and sets the Selected property of all items to false.

Events, Arguments, and Properties

Name Description
SelectedIndexChanged Occurs when the selection from the list control changes between posts to the server.
args As EventArgs
Property Description
CheckBoxList.SelectedIndex Gets or sets the lowest index of the selected items in the list.
CheckBoxList.SelectedItem Gets the selected item with the lowest index in the list control.
CheckBoxList.SelectedValue Gets the value of the selected item with the lowest index in the list control, or selects the item in the list control that contains the specified value.

Top

CommandField

 
<asp:CommandField id="id" Runat="Server"
  ButtonType="Button|Link"
  CancelImageUrl="url"
  CancelText="string"
  CausesValidation="False|True"
  DeleteImageUrl="url"
  DeleteText="string"
  EditImageUrl="url"
  EditText="string"
  FooterText="string"
  HeaderImageUrl="url"
  HeaderText="string"
  InsertImageUrl="url"
  InsertText="string"
  NewImageUrl="url"
  NewText="string"
  SelectImageUrl="url"
  SelectText="string"
  ShowCancelButton="False|True"
  ShowDeleteButton="False|True"
  ShowEditButton="False|True"
  ShowInsertButton="False|True"
  ShowSelectButton="False|True"	
  ShowHeader="False|True"
  UpdateImageUrl="url"
  UpdateText="string"
  ValidationGroup="name"
    
    FooterStyle-property="value"...
    HeaderStyle-property="value"...
    ItemStyle-property="value"...
    ControlStyle-property="value"...
/>

Properties

Name Description
ButtonType Gets or sets the button type to display in the button field.
CancelImageUrl Gets or sets the URL to an image to display for the Cancel button in a CommandField field.
CancelText Gets or sets the caption for the Cancel button displayed in a CommandField field.
CausesValidation Gets or sets a value indicating whether validation is performed when the user clicks a button in a CommandField field.
DeleteImageUrl Gets or sets the URL to an image to display for a Delete button in a CommandField field.
DeleteText Gets or sets the caption for a Delete button in a CommandField field.
EditImageUrl Gets or sets the URL to an image to display for an Edit button in a CommandField field.
EditText Gets or sets the caption for an Edit button in a CommandField field.
FooterText Gets or sets the text that is displayed in the footer item of a data control field.
HeaderImageUrl Gets or sets the URL of an image that is displayed in the header item of a data control field.
HeaderText Gets or sets the text that is displayed in the header item of a data control field.
InsertImageUrl Gets or sets the URL to an image to display for the Insert button in a CommandField field.
InsertText Gets or sets the caption for the Insert button in a CommandField field.
NewImageUrl Gets or sets the URL to an image to display for the New button in a CommandField field.
NewText Gets or sets the caption for the New button in a CommandField field.
SelectImageUrl Gets or sets the URL to an image to display for a Select button in a CommandField field.
SelectText Gets or sets the caption for a Select button in a CommandField field.
ShowCancelButton Gets or sets a value indicating whether a Cancel button is displayed in a CommandField field.
ShowDeleteButton Gets or sets a value indicating whether a Delete button is displayed in a CommandField field.
ShowEditButton Gets or sets a value indicating whether a Delete button is displayed in a CommandField field.
ShowHeader Gets or sets a value indicating whether the header section is displayed in a ButtonFieldBase object.
ShowInsertButton Gets or sets a value indicating whether a New button is displayed in a CommandField field.
ShowSelectButton Gets or sets a value indicating whether a Select button is displayed in a CommandField field.
ShowHeader Gets or sets a value indicating whether the header section is displayed in a ButtonFieldBase object.
SortExpression Gets or sets a sort expression that is used by a data source control to sort data.
UpdateImageUrl Gets or sets the URL to an image to display for an Update button in a CommandField field.
UpdateText Gets or sets the caption for an Update button in a CommandField field.
ValidationGroup Gets or sets the name of the group of validation controls to validate when a button in a ButtonFieldBase object is clicked.

Top

DataGrid

 
<asp:DataGrid id="id" Runat="Server"
  AllowPaging="False|True"
  AllowSorting="False|True"
  AutoGenerateColumns="False|True"
  BackImageUrl="url"
  Caption="string"
  CaptionAlign="Top|Bottom|Left|Right|NotSet"
  CellPadding="n"
  CellSpacing="n"
  DataKeyField="field"
  DataSourceID="id
  GridLines="Both|Horizontal|Vertical|None"
  HorizontalAlign="Left|Center|Right|Justify|NotSet"
  OnSortCommand="subprogram"
  PageButtonCount="n"
  PageSize="n"
  SelectedIndex="n"
  ShowFooter="False|True"
  ShowHeader="False|True"
  
    AlternatingItemStyle-property="value"...
    EditItemStyle-property="value"...
    HeaderStyle-property="value"...
    ItemStyle-property="value"...
    SelectedItemStyle-property="value"...
    FooterStyle-property="value"...
    property="value"...
    
    PagerStyle-Mode="NextPrev|NumericPages"
    PagerStyle-NextPageText="string"
    PagerStyle-PageButtonCount="n"
    PagerStyle-Position="Top|Bottom|TopAndBottom"
    PagerStyle-PreviousPageText="string"
    
    OnCancelCommand="subprogram"
    OnDeleteCommand="subprogram"
    OnEditCommand="subprogram"
    OnItemCommand="subprogram"
    OnPageIndexChangedCommand="subprogram"
    OnSortCommand="subprogram"
    OnUpdateCommand="subprogram"
>
	
  <Columns>
		
    <asp:BoundColumn
      DataField="field"
      DataFormatString="{string}"
      FooterText="string"
      HeaderImageUrl="url"	
      HeaderText="string"
      ReadOnly="False|True"
      SortExpression="field"
        FooterStyle-property="value"...
        HeaderStyle-property="value"...
        ItemStyle-property="value"...
    />
		
    <asp:ButtonColumn
      ButtonType="LinkButton|PushButton"
      CausesValidation="False|True"
      CommandName="string"
      DataTextField="field"
      DataTextFormatString="{string}"
      FooterText="string"
      HeaderImageUrl="url"	
      HeaderText="string"
      SortExpression="field"
      Text="string"
      ValidationGroup="name"
        FooterStyle-property="value"...
        HeaderStyle-property="value"...
        ItemStyle-property="value"...
    />		
		
    <asp:HyperLinkColumn
      DataNavigateUrlField="field"
      DataNavigateUrlFormatString="{string}"
      DataTextField="field"
      DataTextFormatString="{string}"
      FooterText="string"
      HeaderImageUrl="url"	
      HeaderText="string"
      NavigateUrl="url"
      SortExpression="field"
      Target="_blank|_search|_self|_top|_parent|framename"
      Text="string"
        FooterStyle-property="value"...
        HeaderStyle-property="value"...
        ItemStyle-property="value"...
    />
    
    <asp:TemplateColumn
      FooterText="FooterText"
      HeaderImageUrl="url"
      HeaderText="HeaderText"
      SortExpression="field"
        FooterStyle-property="value"...
        HeaderStyle-property="value"...
        ItemStyle-property="value"...
    >

      <HeaderTemplate>
        XHTML and binding expressions
       </HeaderTemplate>
      
      <EditItemTemplate>
        XHTML and binding expressions
      </EditItemTemplate>
			
      <ItemTemplate>
        XHTML and binding expressions
      </ItemTemplate>
			
      <FooterTemplate>
        XHTML and binding expressions
      </FooterTemplate>
			
    </asp:TemplateColumn>
	
  </Columns>

</asp:DataGrid>

Properties

Name Description
AllowPaging Gets or sets a value indicating whether the paging feature is enabled.
AllowSorting Gets or sets a value indicating whether the sorting feature is enabled.
AlternatingItemStyle Gets the style properties for alternating items in the DataGrid control.
AutoGenerateColumns Gets or sets a value that indicates whether BoundColumn objects are automatically created and displayed in the DataGrid control for each field in the data source.
BackImageUrl Gets or sets the URL of an image to display in the background of the DataGrid control.
Caption Gets or sets the text to render in an HTML caption element in the control.
CaptionAlign Gets or sets the horizontal or vertical position of the HTML caption element in a control.
Value Description
Bottom The caption element is aligned with the bottom of the table.
Left The caption element is aligned with the left side of the table.
NotSet The caption alignment is not set. The browser that renders the caption determines where to align the caption.
Right The caption element is aligned with the right side of the table.
Top The caption element is aligned with the top of the table.
CellPadding Gets or sets the amount of space between the contents of a cell and the cell’s border.
CellSpacing Gets or sets the amount of space between cells.
Columns Gets a collection of DataGridColumn objects that represent the columns of the DataGrid control.
Property Description
Count Gets the number of columns in the collection.
Item(index) Gets a DataGridColumn object at a specified index in the collection.
Controls Gets a ControlCollection that contains the child controls of the GridView control.
CurrentPageIndex Gets or sets the index of the currently displayed page.
DataKeyField Gets or sets the key field in the data source specified by the DataSource property.
DataSourceID Gets or sets the ID of the control from which the data-bound control retrieves its list of data items.
EditItemIndex Gets or sets the index of an item in the DataGrid control to edit.
EditItemStyle Gets the style properties of the item selected for editing in the DataGrid control.
FooterStyle Gets the style properties of the footer section in the DataGrid control.
GridLines Gets or sets the gridline style for a DataGrid control.
Value Description
Both Both horizontal and vertical gridlines are rendered.
Horizontal Only horizontal gridlines are rendered.
None No gridlines are rendered.
Vertical Only vertical gridlines are rendered.
HeaderStyle Gets the style properties of the heading section in the DataGrid control.
HorizontalAlign Gets or sets the horizontal alignment of a data listing control within its container.
Value Description
Center The contents of a container are centered.
Justify The contents of a container are uniformly spread out and aligned with both the left and right margins.
Left The contents of a container are left justified.
NotSet The horizontal alignment is not set.
Right The contents of a container are right justified.
ID Gets or sets the programmatic identifier assigned to the server control.
Items Gets a collection of DataGridItem objects that represent the individual items in the DataGrid control.
Property Description
.Count Gets the number of DataGridItem objects in the collection.
.Item(index) Gets a DataGridItem object at a specified index in the collection.
Property Description
.ItemIndex Gets the index of the DataGridItem object.
.ItemType Gets the type (Header, Footer, Item, AlternatingItem, SelectedItem, EditItem, Separator, Pager) of the DataGridItem object.
ItemStyle Gets the style properties of the items in the DataGrid control.
PageCount Gets the total number of pages required to display the items in the DataGrid control.
PagerStyle Gets the style properties of the paging section of the DataGrid control.
PageSize Gets or sets the number of items to display on a single page of the DataGrid control.
SelectedIndex Gets or sets the index of the selected item in a DataGrid control.
SelectedItem Gets a DataGridItem object that represents the selected item in the DataGrid control.
SelectedItemStyle Gets the style properties of the currently selected item in the DataGrid control.
ShowFooter Gets or sets a value that indicates whether the footer is displayed in the DataGrid control.
ShowHeader Gets or sets a value that indicates whether the header is displayed in the DataGrid control.

Events, Arguments, and Properties

Name Description
CancelCommand Occurs when the Cancel button is clicked for an item in the DataGrid control.
args As DataGridCommandEventArgs
Property Description
.CommandArgument Gets the argument for the command.
.CommandName Gets the name of the command.
.CommandSource Gets the source of the command.
.Item Gets the DataGridItem containing the command source.
DeleteCommand Occurs when the Delete button is clicked for an item in the DataGrid control.
args As DataGridCommandEventArgs
Property Description
.CommandArgument Gets the argument for the command.
.CommandName Gets the name of the command.
.CommandSource Gets the source of the command.
.Item Gets the DataGridItem containing the command source.
EditCommand Occurs when the Edit button is clicked for an item in the DataGrid control.
args As DataGridCommandEventArgs
Property Description
.CommandArgument Gets the argument for the command.
.CommandName Gets the name of the command.
.CommandSource Gets the source of the command.
.Item Gets the DataGridItem containing the command source.
ItemCommand Occurs when any button is clicked for an item in the DataGrid control.
args As DataGridCommandEventArgs
Property Description
.CommandArgument Gets the argument for the command.
.CommandName Gets the name of the command.
.CommandSource Gets the source of the command.
.Item Gets the DataGridItem containing the command source.
PageIndexChanged Occurs when one of the page selection elements is clicked.
args As DataGridPageChangedEventArgs
Property Description
.CommandSource Gets the source of the command.
.NewPageIndex Gets the index of the page selected.
SelectedIndexChanged Occurs when a different item is selected in a data listing control between posts to the server.
args As EventArgs
SortCommand Occurs when a column is sorted.
args As DataGridSortCommandEventArgs
Property Description
.CommandSource Gets the source of the command.
.SortExpression Gets the expression used to sort the DataGrid control.
UpdateCommand Occurs when the Update button is clicked for an item in the DataGrid control.
args As DataGridCommandEventArgs
Property Description
.CommandArgument Gets the argument for the command.
.CommandName Gets the name of the command.
.CommandSource Gets the source of the command.
.Item Gets the DataGridItem containing the command source.

Top

DataList

 
<asp:DataList id="id" Runat="Server"
  Caption="string"
  CaptionAlign="Top|Bottom|Left|Right|NotSet"
  CellPadding="n"
  CellSpacing="n"
  DataSourceID="id"
  GridLines="Both|Horizontal|Vertical|None"
  HorizontalAlign="Left|Center|Right|Justify|NotSet"
  RepeatColumns="n"
  RepeatDirection="Vertical|Horizontal"
  RepeatLayout="Table|Flow"
  ShowFooter="True|False"
  ShowHeader="True|False"
  
    AlternatingItemStyle-property="value"...
    EditItemStyle-property="value"...
    FooterStyle-property="value"...
    HeaderStyle-property="value"...
    ItemStyle-property="value"...
    SelectedItemStyle-property="value"...
    SeparatorStyle-property="value"...
    property="value"...
    
    OnCancelCommand="subprogram"
    OnDeleteCommand="subprogram"
    OnEditCommand="subprogram"
    OnItemCommand="subprogram"
    OnUpdateCommand="subprogram"
>
	
  <HeaderTemplate>
    XHTML and binding expressions
  </HeaderTemplate>
  
  <EditItemTemplate>
    XHTML and binding expressions
  </EditItemTemplate>
	 
  <ItemTemplate>
    XHTML and binding expressions
  </ItemTemplate>
	 
  <AlternatingItemTemplate>
    XHTML and binding expressions
  </AlternatingItemTemplate>
  
  <SelectedItemTemplate>
    XHTML and binding expressions
  </SelectedItemTemplate>
  
  <SeparatorTemplate>
    XHTML and binding expressions
  </SeparatorTemplate>
	 
  <FooterTemplate>
    XHTML and binding expressions
  </FooterTemplate>

</asp:DataList>

Properties

Name Description
AlternatingItemStyle Gets the style properties for alternating items in the DataList control.
AlternatingItemTemplate Gets or sets the template for alternating items in the DataList.
Caption Gets or sets the text to render in an HTML caption element in a DataList control.
CaptionAlign Gets or sets the horizontal or vertical position of the HTML caption element in a DataList control.
Value Description
Bottom The caption element is aligned with the bottom of the table.
Left The caption element is aligned with the left side of the table.
NotSet The caption alignment is not set. The browser that renders the caption determines where to align the caption.
Right The caption element is aligned with the right side of the table.
Top The caption element is aligned with the top of the table.
CellPadding Gets or sets the amount of space between the contents of a cell and the cell’s border.
CellSpacing Gets or sets the amount of space between cells.
Controls Gets a ControlCollection that contains the child controls of the DataList.
DataSourceID Gets or sets the ID of the control from which the data-bound control retrieves its list of data items.
EditItemIndex Gets or sets the index number of the selected item in the DataList control to edit.
EditItemStyle Gets the style properties for the item selected for editing in the DataList control.
EditItemTemplate Gets or sets the template for the item selected for editing in the DataList control.
FooterStyle Gets the style properties for the footer section of the DataList control.
FooterTemplate Gets or sets the template for the footer section of the DataList control.
GridLines Gets or sets the gridline style for a DataList control.
Value Description
Both Both horizontal and vertical gridlines are rendered.
Horizontal Only horizontal gridlines are rendered.
None No gridlines are rendered.
Vertical Only vertical gridlines are rendered.
HeaderStyle Gets the style properties for the heading section of the DataList control.
HeaderTemplate Gets or sets the template for the footer section of the DataList control.
HorizontalAlign Gets or sets the horizontal alignment of a data listing control within its container.
Value Description
Center The contents of a container are centered.
Justify The contents of a container are uniformly spread out and aligned with both the left and right margins.
Left The contents of a container are left justified.
NotSet The horizontal alignment is not set.
Right The contents of a container are right justified.
ID Gets or sets the programmatic identifier assigned to the server control.
Items Gets a collection of DataListItem objects representing the individual items within the control.
Property Description
.Count Gets the number of DataListItem objects in the collection.
.Item(index) Gets a DataListItem object at a specified index in the collection.
Property Description
.ItemIndex Gets the index of the DataListItem object.
.ItemType Gets the type (Header, Footer, Item, AlternatingItem, SelectedItem, EditItem, Separator) of the DataListItem object.
ItemStyle Gets the style properties for the items in the DataList control.
ItemTemplate Gets or sets the template for the items in the DataList control.
RepeatColumns Gets or sets the number of columns to display in the DataList control.
RepeatDirection Gets or sets whether the DataList control displays vertically or horizontally.
RepeatLayout Gets or sets whether the control is displayed in a table or flow layout.
SelectedIndex Gets or sets the index of the selected item in the DataList control.
SelectedItem Gets the selected item in the DataList control.
SelectedItemStyle Gets the style properties for the selected item in the DataList control.
SelectedItemTemplate Gets or sets the template for the selected item in the DataList control.
SelectedValue Gets the value of the key field for the selected data list item.
SeparatorStyle Gets the style properties of the separator between each item in the DataList control.
SeparatorTemplate Gets or sets the template for the separator between the items of the DataList control.
ShowFooter Gets or sets a value indicating whether the footer section is displayed in the DataList control.
ShowHeader Gets or sets a value indicating whether the header section is displayed in the DataList control.

Events, Arguments, and Properties

Name Description
CancelCommand Occurs when the Cancel button is clicked for an item in the DataList control.
args As DataListCommandEventArgs
Name Description
.CommandArgument Gets the argument for the command.
.CommandName Gets the name of the command.
.CommandSource Gets the source of the command.
.Item Gets the DataListItem containing the command source.
DeleteCommand Occurs when the Delete button is clicked for an item in the DataList control.
args As DataListCommandEventArgs
Name Description
.CommandArgument Gets the argument for the command.
.CommandName Gets the name of the command.
.CommandSource Gets the source of the command.
.Item Gets the item containing the command source.
EditCommand Occurs when the Edit button is clicked for an item in the DataList control.
args As DataListCommandEventArgs
Name Description
.CommandArgument Gets the argument for the command.
.CommandName Gets the name of the command.
.CommandSource Gets the source of the command.
.Item Gets the item containing the command source.
ItemCommand Occurs when any button is clicked for an item in the DataList control.
args As DataListCommandEventArgs
Name Description
.CommandArgument Gets the argument for the command.
.CommandName Gets the name of the command.
.CommandSource Gets the source of the command.
.Item Gets the item containing the command source.
SelectedIndexChanged Occurs when a different item is selected in a data listing control between posts to the server.
args As EventArgs
UpdateCommand Occurs when the Update button is clicked for an item in the DataList control.
args As DataListCommandEventArgs
Name Description
.CommandArgument Gets the argument for the command.
.CommandName Gets the name of the command.
.CommandSource Gets the source of the command.
.Item Gets the item containing the command source.

Top

DetailsView

 
<asp:DetailsView id="id" Runat="Server"
  AllowPaging="True|False"
  AutoGenerateDeleteButton="True|False"
  AutoGenerateEditButton="True|False"
  AutoGenerateInsertButton="True|False"
  AutoGenerateRows="True|False"
  BackImageUrl="url"
  Caption="string"
  CaptionAlign="Top|Bottom|Left|Right|NotSet"
  CellPadding="n"
  CellSpacing="n"
  DateKeyNames="field [,field]"
  DataSourceID="id"
  EmptyDataText="string"
  DefaultMode="Edit|Insert|ReadOnly"
  FooterText="string"
  GridLines="Both|Horizontal|Vertical|None"
  HeaderText="string"
  HorizontalAlign="Left|Center|Right|Justify|NotSet"
  
    AlternatingRowStyle-property="value"...
    CommandRowStyle-property="value"...
    EditRowStyle-property="value"...
    EmptyDataRowStyle-property="value"...
    FieldHeaderStyle-property="value"...
    FooterStyle-property="value"...
    HeaderStyle-property="value"...
    InsertRowStyle-property="value"...
    RowStyle-property="value"...
    property="value"...	
	 
    PagerSettings-property="value"...
    PagerStyle-property="value"...
    
    OnItemCommand="subprogram"
    OnItemDeleted="subprogram"
    OnItemDeleting="subprogram"
    OnItemInserted="subprogram"
    OnItemInserting="subprogram"
    OnItemUpdated="subprogram"
    OnItemUpdating="subprogram"
    OnModeChanged="subprogram"
    OnModeChanging="subprogram"
    OnPageIndexChanged="subprogram"
    OnPageIndexChanging="subprogram"
>

  <HeaderTemplate>
    XHTML, text and server controls
  </HeaderTemplate>
  
  <EmptyDataTemplate>
    XHTML, text and server controls
  </EmptyDataemplate>
  
  <FooterTemplate>
    XHTML, text and server controls
  </FooterTemplate>

  <PagerTemplate>
    XHTML, text and server controls
  </PagerTemplate>
  
  <PagerSettings.../>
  
  
  <Fields>
    
    <asp:BoundField.../>
    
    <asp:ButtonField.../>
    
    <asp:CheckBoxField.../>
    
    <asp:HyperLinkField.../>
    
    <asp:ImageField.../>
    
    <asp:TemplateField.../>
    ...
  
  </Fields>

</asp:DetailsView>

Properties

Name Description
AllowPaging Gets or sets a value indicating whether the paging feature is enabled.
AlternatingRowStyle Gets a reference to the TableItemStyle object that allows you to set the appearance of the alternating data rows in a DetailsView control.
AutoGenerateDeleteButton Gets or sets a value indicating whether the built-in control to delete the current record is displayed in a DetailsView control.
AutoGenerateEditButton Gets or sets a value indicating whether the built-in controls to edit the current record are displayed in a DetailsView control.
AutoGenerateInsertButton Gets or sets a value indicating whether the built-in controls to insert a new record are displayed in a DetailsView control.
AutoGenerateRows Gets or sets a value indicating whether row fields for each field in the data source are automatically generated and displayed in a DetailsView control.
BackImageUrl Gets or sets the URL to an image to display in the background of a DetailsView control.
BottomPagerRow Gets a DetailsViewRow object that represents the bottom pager row in a DetailsView control.
Caption Gets or sets the text to render in an HTML caption element in a DetailsView control.
CaptionAlign Gets or sets the horizontal or vertical position of the HTML caption element in a DetailsView control.
Value Description
Bottom The caption element is aligned with the bottom of the table.
Left The caption element is aligned with the left side of the table.
NotSet The caption alignment is not set. The browser that renders the caption determines where to align the caption.
Right The caption element is aligned with the right side of the table.
Top The caption element is aligned with the top of the table.
CellPadding Gets or sets the amount of space between the contents of a cell and the cell’s border.
CellSpacing Gets or sets the amount of space between cells.
CommandRowStyle Gets a reference to the TableItemStyle object that allows you to set the appearance of a command row in a DetailsView control.
Controls Gets a ControlCollection that contains the child controls of the DetailsView control.
CurrentMode Gets the current data-entry mode of the DetailsView control.
DataItem Gets the data item bound to the DetailsView control.
DataItemCount Gets the number of items in the underlying data source.
DataItemIndex Gets the index of the item being displayed in a DetailsView control from the underlying data source.
DataKey Gets a DataKey object that represents the primary key of the displayed record.
DataKeyNames Gets or sets an array that contains the names of the key fields for the data source.
DataSourceID Gets or sets the ID of the control from which the data-bound control retrieves its list of data items.
DefaultMode Get or sets the default data-entry mode of the DetailsView control.
Mode Description
Edit An editing mode that allows the user to update the values of an existing record.
Insert An inserting mode that allows the user to enter the values for a new record.
ReadOnly A display mode that prevents the user from modifying the values of a record.
EditRowStyle Gets a reference to the TableItemStyle object that allows you to set the appearance of the data rows when a DetailsView control is in edit mode.
EmptyDataRowStyle Gets a reference to the TableItemStyle object that allows you to set the appearance of the empty data row displayed when the data source bound to a DetailsView control does not contain any records.
EmptyDataTemplate Gets or sets the user-defined content for the empty data row rendered when a DetailsView control is bound to a data source that does not contain any records.
EmptyDataText Gets or sets the text to display in the empty data row rendered when a DetailsView control is bound to a data source that does not contain any records.
EnablePagingCallbacks Gets or sets a value indicating whether client-side callback functions are used for paging operations in the DetailsView control.
FieldHeaderStyle Gets a reference to the TableItemStyle object that allows you to set the appearance of the header column in a DetailsView control.
Fields Gets a collection of DataControlField objects that represent the explicitly declared row fields in a DetailsView control.
FooterRow Gets a DetailsViewRow object that represents the footer row in a DetailsView control.
FooterStyle Gets a reference to the TableItemStyle object that allows you to set the appearance of the footer row in a DetailsView control.
FooterTemplate Gets or sets the user-defined content for the footer row in a DetailsView control.
FooterText Gets or sets the text to display in the footer row of a DetailsView control.
GridLines Gets or sets the gridline style for a DetailsView control.
Value Description
Both Both horizontal and vertical gridlines are rendered.
Horizontal Only horizontal gridlines are rendered.
None No gridlines are rendered.
Vertical Only vertical gridlines are rendered.
HeaderRow Gets a DetailsViewRow object that represents the header row in a DetailsView control.
HeaderStyle Gets a reference to the TableItemStyle object that allows you to set the appearance of the header row in a DetailsView control.
HeaderTemplate Gets or sets the user-defined content for the header row in a DetailsView control.
HeaderText Gets or sets the text to display in the header row of a DetailsView control.
HorizontalAlign Gets or sets the horizontal alignment of a DetailsView control on the page.
Value Description
Center The contents of a container are centered.
Justify The contents of a container are uniformly spread out and aligned with both the left and right margins.
Left The contents of a container are left justified.
NotSet The horizontal alignment is not set.
Right The contents of a container are right justified.
ID Gets or sets the programmatic identifier assigned to the server control.
InsertRowStyle Gets a reference to the TableItemStyle object that allows you to set the appearance of the data rows in a DetailsView control when the DetailsView control is in insert mode.
PageCount Gets the number of records in the data source.
PageIndex Gets or sets the index of the displayed record.
PagerSettings Gets a reference to the PagerSettings object that allows you to set the properties of the pager buttons in a DetailsView control.
PagerStyle Gets a reference to the TableItemStyle object that allows you to set the appearance of the pager row in a DetailsView control.
Rows Gets a collection of DetailsViewRow objects that represent the data rows in a DetailsView control.
Property Description
.Count Gets the number of items in the DetailsViewRowCollection object.
.Item(index) Gets a DetailsViewRow object at a specified index in the collection.
Property Description
.RowIndex Gets the index of the DetailsViewRow object.
.RowState Gets the state (Alternate, Edit, Insert, Normal) of the DetailsViewRow object.
.RowType Gets the type (DataRow, EmptyDataRow, Footer, Header, Pager) of the DetailsViewRow object.
RowStyle Gets a reference to the TableItemStyle object that allows you to set the appearance of the data rows in a DetailsView control.
SelectedValue Gets the data key value of the current record in a DetailsView control.
TopPagerRow Gets a DetailsViewRow object that represents the top pager row in a DetailsView control.

Methods

Name Description
ChangeMode Switches the DetailsView control to the specified mode.
Mode Description
DetailsViewMode.Edit The DetailsView control is in edit mode, which allows the user to update the values of a record.
DetailsViewMode.Inset The DetailsView control is in insert mode, which allows the user to add a new record to the data source.
DetailsView.ReadOnly The DetailsView control is in read-only mode, which is the normal display mode.
DeleteItem Deletes the current record from the data source.
InsertItem Inserts the current record in the data source.
IsBindableType Determines whether the specified data type can be bound to a field in the DetailsView control.

Events, Arguments, and Properties

Name Description
ItemCommand Occurs when a button within a DetailsView control is clicked.
args As DetailsViewCommandEventArgs
Name Description
.CommandArgument Gets the argument for the command.
.CommandName Gets the name of the command.
.CommandSource Gets the source of the command.
ItemDeleted Occurs when a Delete button within a DetailsView control is clicked, but after the delete operation.
args As DetailsViewDeletedEventArgs
Name Description
.AffectedRows Gets the number of rows affected by the delete operation.
.Keys("name") Gets an ordered dictionary of key field name/value pairs that contains the names and values of the key fields of the deleted items.
.Values("name") Gets a dictionary of the non-key field name/value pairs for the item to delete.
ItemDeleting Occurs when a Delete button within a DetailsView control is clicked, but before the delete operation.
args As DetailsViewDeleteEventArgs
Name Description
.Cancel Gets or sets a value indicating whether the event should be canceled.
.Keys("name") Gets an ordered dictionary of key field name/value pairs that contains the names and values of the key fields of the deleted items.
.RowIndex Gets the index of the row being deleted.
.Values("name") Gets a dictionary of the non-key field name/value pairs for the item to delete.
ItemInserted Occurs when an Insert button within a DetailsView control is clicked, but after the insert operation.
args As DetailsViewInsertedEventArgs
Name Description
.AffectedRows Gets the number of rows affected by the insert operation.
.KeepInInsertMode Gets or sets a value indicating whether the DetailsView control should remain in insert mode after an insert operation.
.Values("name") Gets a dictionary that contains the field name/value pairs for the inserted record.
ItemInserting Occurs when an Insert button within a DetailsView control is clicked, but before the insert operation.
args As DetailsViewInsertEventArgs
Name Description
.Cancel Gets or sets a value indicating whether the event should be canceled.
.CommandArgument Gets the command argument for the insert operation passed to the DetailsView control.
.Values("name") Gets a dictionary that contains the field name/value pairs for the record to insert.
ItemUpdated Occurs when an Update button within a DetailsView control is clicked, but after the update operation.
args As DetailsViewUpdatedEventArgs
Name Description
.AffectedRows Gets the number of rows affected by the update operation.
.KeepInEditMode Gets or sets a value indicating whether the DetailsView control should remain in edit mode after an update operation.
.Keys("name") Gets a dictionary that contains the key field name/value pairs for the updated record.
.NewValues("name") Gets a dictionary that contains the new field name/value pairs for the updated record.
.OldValues("name") Gets a dictionary that contains the original field name/value pairs for the updated record.
ItemUpdating Occurs when an Update button within a DetailsView control is clicked, but before the update operation. 
args As DetailsViewUpdateEventArgs
Name Description
.Cancel Gets or sets a value indicating whether the event should be canceled.
.CommandArgument Gets the command argument for the update operation passed to the DetailsView control.
.Keys("name") Gets a dictionary that contains the key field name/value pairs for the record to update.
.NewValues("name") Gets a dictionary that contains the new field name/value pairs for the record to update.
.OldValues("name") Gets a dictionary that contains the original field name/value pairs for the record to update.
ModeChanged Occurs when a DetailsView control attempts to change between edit, insert, and read-only mode, but after the CurrentMode property is updated.
ModeChanging Occurs when a DetailsView control attempts to change between edit, insert, and read-only mode, but before the CurrentMode property is updated.
args As DetailsViewModeEventArgs
Name Description
.Cancel Gets or sets a value indicating whether the event should be canceled.
.CancelingEdit Gets a value indicating whether the ModeChanging event was raised as a result of the user canceling an edit operation.
.NewMode Gets or sets the mode to which the DetailsView control is changing.
PageIndexChanged Occurs when the value of the PageIndex property changes after a paging operation.
PageIndexChanging Occurs when the value of the PageIndex property changes before a paging operation.
args As DetailsViewPageEventArgs
Name Description
.Cancel Gets or sets a value indicating whether the event should be canceled.
.NewPageIndex Gets or sets the index of the new page to display in the DetailsView control.

Top

DropDownList

 
<asp:DropDownList id="id" Runat="Server"
  AutoPostBack="True|False"
  CausesValidation="True|False"
  DataSourceID="id"
  DataTextField="field"
  DataTextFormatString="{string}"
  DataValueField="field"
  ValidationGroup="name"

    property="value"...

    OnSelectedIndexChanged="subprogram"
>

  <asp:ListItem
    Selected="False|True"
    Text="string"
    Value="value"
  />
  ...

</asp:DropDownList>

Properties

Name Description
AutoPostBack Gets or sets a value indicating whether a postback to the server automatically occurs when the user changes the list selection.
CausesValidation Gets or sets a value indicating whether validation is performed when a control that is derived from the ListControl class is clicked.
DataSourceID Gets or sets the ID of the control from which the data-bound control retrieves its list of data items.
DataTextField Gets or sets the field of the data source that provides the text content of the list items.
DataTextFormatString Gets or sets the formatting string used to control how data bound to the list control is displayed.
DataValueField Gets or sets the field of the data source that provides the value of each list item.
ID Gets or sets the programmatic identifier assigned to the server control.
Items Gets the collection of ListItems in the list control.
Property Description
.Count Gets the number of ListItem objects in the collection.
(index) Gets a ListItem object at a specified index in the collection.
Property Description
.Selected Gets or sets whether the ListItem is selected.
.Text Gets or sets the text displayed in the ListItem.
.Value Gets or sets the value associated with the ListItem.
Method Description
.Clear() Clear all items from a ListItem collection.
.FindByText("text")
Searches the collection for a ListItem with a Text property that contains the specified value.
.FindByValue("value")
Searches the collection for a ListItem with a Value property that contains the specified value.
.RemoveAt(index) Remove an item from the ListItem at the index location in the collection.
.Add(New ListItem("text","value"))
Add a new ListItem next in order in the collection.
.Insert(index, New ListItem("text","value"))
Add a new ListItem at the index location in the collection.
SelectedIndex Gets or sets the index of the selected item in the DropDownList control.
SelectedItem Gets the selected item with the lowest index in the list control.
SelectedValue Gets the value of the selected item in the list control, or selects the item in the list control that contains the specified value.
ValidationGroup Gets or sets the group of controls for which the control that is derived from the ListControl class causes validation when it posts back to the server.

Events and Arguments

Name Description
SelectedIndexChanged Occurs when the selection from the list control changes between posts to the server.
args As EventArgs
Name Description
DropDownList.SelectedIndex Gets or sets the index of the selected item in the DropDownList control.
DropDownList.SelectedItem Gets the selected item in the DropDownList control.
Property Description
.Text Gets the text of the selected item.
.Value Gets the value of the selected item.
DropDownList.SelectedValue Gets the value of the selected item in the DropDownList control, or selects the item in the DropDownList that contains the specified value.

Top

FileUpload

 
<asp:FileUpload id="id" Runat="Server"/>

Properties

Name Description
FileBytes Returns an array of the bytes in a file that is specified using a FileUpload control.
FileContent Gets a Stream object that points to a file to upload using the FileUpload control.
FileName Gets the name of a file on a client to upload using the FileUpload control.
HasFile Gets a value indicating whether the FileUpload control contains a file.
ID Gets or sets the programmatic identifier assigned to the server control.
PostedFile Gets the underlying HttpPostedFile object for a file that is uploaded using the FileUpload control.

Methods

Name Description
SaveAs Saves the contents of a file that is uploaded using the FileUpload control to a specified path on the Web server.

Top

FormView

 
<asp:FormView id="id" Runat="Server"
  AllowPaging="True|False"
  BackImageUrl="url"
  Caption="string"
  CaptionAlign="Top|Bottom|Left|Right|NotSet"
  CellPadding="n"
  CellSpacing="n"
  DataKeyNames="field [,field]"
  DataSourceID="id"
  DefaultMode="Edit|Insert|ReadOnly"
  EmptyDataText="string"
  FooterText="string"
  GridLines="Both|Horizontal|Vertical|None"
  HeaderText="string"
  HorizontalAlign="Left|Center|Right|Justify|NotSet"
	
  EditRowStyle-property="value"...
  EmptyDataRowStyle-property="value"...
  HeaderStyle-property="value"...
  RowStyle-property="value"...
  FooterStyle-property="value"...
  property="value"...
		
  PagerSettings-property="value"...
  PagerStyle-property="value"...
>

  <HeaderTemplate>
    XHTML, text and server controls
  </HeaderTemplate>
		
  <ItemTemplate>
    XHTML, text and server controls
  </ItemTemplate>
  
  <InsertItemTemplate>
    XHTML, text and server controls
  </InsertItemTemplate>

  <EditItemTemplate>
    XHTML, text and server controls
  </EditItemTemplate>
  
  <EmptyDataTemplate>
    XHTML, text and server controls
  </EmptyDataemplate>
  
  <FooterTemplate>
    XHTML, text and server controls
  </FooterTemplate>

  <PagerSettings.../>

</asp:FormView>

Properties

Name Description
AllowPaging Gets or sets a value indicating whether the paging feature is enabled.
BackImageUrl Gets or sets the URL to an image to display in the background of a FormView control.
BottomPagerRow Gets the FormViewRow object that represents the pager row displayed at the bottom of the FormView control.
Caption Gets or sets the text to render in an HTML caption element in a FormView control.
CaptionAlign Gets or sets the horizontal or vertical position of the HTML caption element in a FormView control.
Value Description
Bottom The caption element is aligned with the bottom of the table.
Left The caption element is aligned with the left side of the table.
NotSet The caption alignment is not set. The browser that renders the caption determines where to align the caption.
Right The caption element is aligned with the right side of the table.
Top The caption element is aligned with the top of the table.
CellPadding Gets or sets the amount of space between the contents of a cell and the cell’s border.
CellSpacing Gets or sets the amount of space between cells.
Controls Gets a ControlCollection that contains the child controls of the FormView control.
CurrentMode Gets the current data-entry mode of the FormView control.
DataItem Gets the data item bound to the FormView control.
DataItemCount Gets the number of data items in the data source.
DataItemIndex Gets the index of the data item bound to the FormView control from the data source.
DataKey Gets a DataKey object that represents the primary key of the displayed record.
DataKeyNames Gets or sets an array that contains the names of the key fields for the data source.
DataSourceID Gets or sets the ID of the control from which the data-bound control retrieves its list of data items.
DefaultMode Gets or sets the data-entry mode to which the FormView control returns after an update, insert, or cancel operation.
Mode Description
Edit An editing mode that allows the user to update the values of an existing record.
Insert An inserting mode that allows the user to enter the values for a new record.
ReadOnly A display mode that prevents the user from modifying the values of a record.
EditItemTemplate Gets or sets the custom content for an item in edit mode.
EditRowStyle Gets a reference to the TableItemStyle object that allows you to set the appearance of the data row when a FormView control is in edit mode.
EmptyDataRowStyle Gets a reference to the TableItemStyle object that allows you to set the appearance of the empty data row displayed when the data source bound to a FormView control does not contain any records.
EmptyDataTemplate Gets or sets the user-defined content for the empty data row rendered when a FormView control is bound to a data source that does not contain any records.
EmptyDataText Gets or sets the text to display in the empty data row rendered when a FormView control is bound to a data source that does not contain any records.
FooterRow Gets the FormViewRow object that represents the footer row in a FormView control.
FooterStyle Gets a reference to the TableItemStyle object that allows you to set the appearance of the footer row in a FormView control.
FooterTemplate Gets or sets the user-defined content for the footer row in a FormView control.
FooterText Gets or sets the text to display in the footer row of a FormView control.
GridLines Gets or sets the gridline style for a FormView control.
Value Description
Both Both horizontal and vertical gridlines are rendered.
Horizontal Only horizontal gridlines are rendered.
None No gridlines are rendered.
Vertical Only vertical gridlines are rendered.
HeaderRow Gets the FormViewRow object that represents the header row in a FormView control.
HeaderStyle Gets a reference to the TableItemStyle object that allows you to set the appearance of the header row in a FormView control.
HeaderTemplate Gets or sets the user-defined content for the header row in a FormView control.
HeaderText Gets or sets the text to display in the header row of a FormView control.
HorizontalAlign Gets or sets the horizontal alignment of a FormView control on the page.
Value Description
Center The contents of a container are centered.
Justify The contents of a container are uniformly spread out and aligned with both the left and right margins.
Left The contents of a container are left justified.
NotSet The horizontal alignment is not set.
Right The contents of a container are right justified.
ID Gets or sets the programmatic identifier assigned to the server control.
InsertItemTemplate Gets or sets the custom content for an item in insert mode.
InsertRowStyle Gets a reference to the TableItemStyle object that allows you to set the appearance of the data row in a FormView control when the control is in insert mode.
ItemTemplate Gets or sets the custom content for the data row in a FormView control when the control is in read-only mode.
PageCount Gets the total number of pages required to display every record in the data source.
PageIndex Gets or sets the index of the displayed page.
PagerSettings Gets a reference to the PagerSettings object that allows you to set the properties of the pager buttons in a FormView control.
PagerStyle Gets a reference to the TableItemStyle object that allows you to set the appearance of the pager row in a FormView control.
PagerTemplate Gets or sets the custom content for the pager row in a FormView control.
Row Gets the FormViewRow object that represents the data row in a FormView control.
Property Description
RowState Gets the state (Edit, Insert, Normal, Selected) of the FormViewRow object.
RowType Gets the type (DataRow, EmptyDataRow, Footer, Header, Pager, Separator) of the FormViewRow object.
RowStyle Gets a reference to the TableItemStyle object that allows you to set the appearance of the data row in a FormView control when the control is in read-only mode.
SelectedValue Gets the data key value of the current record in a FormView control.
TopPagerRow Gets the FormViewRow object that represents the pager row displayed at the top of a FormView control.

Methods

Name Description
ChangeMode Switches the FormView control to the specified data-entry mode.
DeleteItem Deletes the current record in the FormView control from the data source.
InsertItem Inserts the current record in the data source.
IsBindableType Determines whether the specified data type can be bound to a field in the FormView control.
UpdateItem Updates the current record in the data source.

Events, Arguments, and Properties

Name Description
ItemCommand Occurs when a button within a FormView control is clicked.
args As FormViewCommandEventArgs
Name Description
.CommandArgument Gets the argument for the command.
.CommandName Gets the name of the command.
.CommandSource Gets the source of the command.
ItemCreated Occurs after all the rows are created in a FormView control.
args As FormViewCreatedEventArgs
Name Description
.AffectedRows Gets the number of rows affected by the create operation.
.Keys("name") Gets an ordered dictionary of key field name/value pairs that contains the names and values of the key fields of the created items.
.Values("name") Gets a dictionary of the non-key field name/value pairs for the items created.
ItemDeleted Occurs when a Delete button within a FormView control is clicked, but after the delete operation.
args As FormViewDeletedEventArgs
Name Description
.AffectedRows Gets the number of rows affected by the delete operation.
.Keys("name") Gets an ordered dictionary of key field name/value pairs that contains the names and values of the key fields of the deleted items.
.Values("name") Gets a dictionary of the non-key field name/value pairs for the items deleted.
ItemDeleting Occurs when a Delete button within a FormView control is clicked, but before the delete operation.
args As FormViewDeleteEventArgs
Name Description
.Cancel Gets or sets a value indicating whether the event should be canceled.
.Keys("name") Gets an ordered dictionary of key field name/value pairs that contains the names and values of the key fields of the items to be deleted.
.RowIndex Gets the index of the row being deleted.
.Values("name") Gets a dictionary of the non-key field name/value pairs for the items to be deleted.
ItemInserted Occurs when an Insert button within a FormView control is clicked, but after the insert operation.
args As FormViewInsertedEventArgs
Name Description
.AffectedRows Gets the number of rows affected by the insert operation.
.KeepInInsertMode Gets or sets a value indicating whether the DetailsView control should remain in insert mode after an insert operation.
.Values("name") Gets a dictionary that contains the field name/value pairs for the inserted record.
ItemInserting Occurs when an Insert button within a FormView control is clicked, but before the insert operation.
args As FormViewInsertEventArgs
Name Description
.Cancel Gets or sets a value indicating whether the event should be canceled.
.CommandArgument Gets the command argument for the insert operation passed to the FormView control.
.Values("name") Gets a dictionary that contains the field name/value pairs for the record to insert.
ItemUpdated Occurs when an Update button within a FormView control is clicked, but after the update operation.
args As FormViewUpdatedEventArgs
Name Description
.AffectedRows Gets the number of rows affected by the update operation.
.KeepInEditMode Gets or sets a value indicating whether the FormView control should remain in edit mode after an update operation.
.Keys("name") Gets a dictionary that contains the key field name/value pairs for the update operation.
.NewValues("name") Gets a dictionary that contains the new field name/value pairs for the updated record.
.OldValues("name") Gets a dictionary that contains the original field name/value pairs for the updated record.
ItemUpdating Occurs when an Update button within a FormView control is clicked, but before the update operation.
args As FormViewUpdateEventArgs
Name Description
.Cancel Gets or sets a value indicating whether the event should be cancelled.
.CommandArgument Gets the command argument for the update operation passed to the FormView control.
.Keys("name") Gets a dictionary that contains the key field name/value pairs for the record to update.
.NewValues("name") Gets a dictionary that contains the new field name/value pairs for the record to update.
.OldValues("name") Gets a dictionary that contains the original field name/value pairs for the record to update.
ModeChanged Occurs when the FormView control switches between edit, insert, and read-only mode, but after the mode has changed.
ModeChanging Occurs when the FormView control switches between edit, insert, and read-only mode, but before the mode changes.
args As FormViewModeEventArgs
Name Description
.Cancel Gets or sets a value indicating whether the event should be cancelled.
.CancellingEdit Gets a value indicating whether the ModeChanging event was raised as a result of the user canceling an edit operation.
.NewMode Gets or sets the mode to which the FormView control is changing.
PageIndexChanged Occurs when the value of the PageIndex property changes after a paging operation. 
PageIndexChanging Occurs when the value of the PageIndex property changes before a paging operation.
args As FormViewPageEventArgs
Name Description
.Cancel Gets or sets a value indicating whether the event should be cancelled.
.NewPageIndex Gets or sets the index of the new page to display in the FormView control.

Top

GridView

 
<asp:GridView id="id" Runat="Server"
  AllowPaging="True|False"
  AllowSorting="True|False"
  AutoGenerateColumns="True|False"
  AutoGenerateDeleteButton="True|False"
  AutoGenerateEditButton="True|False"
  AutoGenerateSelectButton="True|False"
  BackImageUrl="url"
  Caption="string"
  CaptionAlign="Top|Bottom|Left|Right|NotSet"
  CellPadding="n"
  CellSpacing="n"
  DataKeyNames="field [,field]"
  DataSourceID="id"
  EmptyDataText="string"
  GridLines="Both|Horizontal|Vertical|None"
  HorizontalAlign="Left|Center|Right|Justify|NotSet"
  PageIndex="n"
  PageSize="n"
  ShowFooter="True|False"
  ShowHeader="True|False"
  
  AlternatingRowStyle-property="value"...
  EditRowStyle-property="value"...
  EmptyDataRowStyle-property="value"...
  FooterStyle-property="value"...
  HeaderStyle-property="value"...
  RowStyle-property="value"...
  SelectedRowStyle-property="value"...
  property="value"...

  PagerSettings-property="value"...
  PagerStyle-property="value"...
>

  <HeaderTemplate>
    XHTML, text and server controls
  </HeaderTemplate>
  
  <EmptyDataTemplate>
    XHTML, text and server controls
  </EmptyDataTemplate>
  
  <FooterTemplate>
    XHTML, text and server controls
  </FooterTemplate>
  
  <PagerTemplate>
    XHTML, text and server controls
  </PagerTemplate>

  <PagerSettings.../>
  
  
  <Columns>
    
    <asp:BoundField.../>
    
    <asp:ButtonField.../>
    
    <asp:CheckBoxField.../>
    
    <asp:HyperLinkField.../>
    
    <asp:ImageField.../>
    
    <asp:TemplateField.../>
    ...
  
  </Columns>

</asp:GridView>

Properties

Name Description
AllowPaging Gets or sets a value indicating whether the paging feature is enabled.
AllowSorting Gets or sets a value indicating whether the sorting feature is enabled.
AlternatingRowStyle Gets a reference to the TableItemStyle object that allows you to set the appearance of alternating data rows in a GridView control.
AutoGenerateColumns Gets or sets a value indicating whether bound fields are automatically created for each field in the data source.
AutoGenerateDeleteButton Gets or sets a value indicating whether a CommandField field column with a Delete button for each data row is automatically added to a GridView control.
AutoGenerateEditButton Gets or sets a value indicating whether a CommandField field column with an Edit button for each data row is automatically added to a GridView control.
AutoGenerateSelectButton Gets or sets a value indicating whether a CommandField field column with a Select button for each data row is automatically added to a GridView control.
BackImageUrl Gets or sets the URL to an image to display in the background of a GridView control.
BottomPagerRow Gets a GridViewRow object that represents the bottom pager row in a GridView control.
Caption Gets or sets the text to render in an HTML caption element in a GridView control.
CaptionAlign Gets or sets the horizontal or vertical position of the HTML caption element in a GridView control.
Value Description
Bottom The caption element is aligned with the bottom of the table.
Left The caption element is aligned with the left side of the table.
NotSet The caption alignment is not set. The browser that renders the caption determines where to align the caption.
Right The caption element is aligned with the right side of the table.
Top The caption element is aligned with the top of the table.
CellPadding Gets or sets the amount of space between the contents of a cell and the cell’s border.
CellSpacing Gets or sets the amount of space between cells.
Columns Gets a collection of DataControlField objects that represent the column fields in a GridView control.
Controls Gets a ControlCollection that contains the child controls of the GridView control.
DataSourceID Gets or sets the ID of the control from which the data-bound control retrieves its list of data items.
EditIndex Gets or sets the index of the row to edit.
EditRowStyle Gets a reference to the TableItemStyle object that allows you to set the appearance of the row selected for editing in a GridView control.
EmptyDataRowStyle Gets a reference to the TableItemStyle object that allows you to set the appearance of the empty data row rendered when a GridView control is bound to a data source that does not contain any records.
EmptyDataTemplate Gets or sets the user-defined content for the empty data row rendered when a GridView control is bound to a data source that does not contain any records.
EmptyDataText Gets or sets the text to display in the empty data row rendered when a GridView control is bound to a data source that does not contain any records.
EnableSortingAndPagingCallbacks Gets or sets a value indicating whether client-side callbacks are used for sorting and paging operations.
FooterRow Gets a GridViewRow object that represents the footer row in a GridView control.
FooterStyle Gets a reference to the TableItemStyle object that allows you to set the appearance of the footer row in a GridView control.
GridLines Gets or sets the gridline style for a GridView control.
Value Description
Both Both horizontal and vertical gridlines are rendered.
Horizontal Only horizontal gridlines are rendered.
None No gridlines are rendered.
Vertical Only vertical gridlines are rendered.
HeaderRow Gets a GridViewRow object that represents the header row in a GridView control.
HeaderStyle Gets a reference to the TableItemStyle object that allows you to set the appearance of the header row in a GridView control.
HorizontalAlign Gets or sets the horizontal alignment of a GridView control on the page.
Value Description
Center The contents of a container are centered.
Justify The contents of a container are uniformly spread out and aligned with both the left and right margins.
Left The contents of a container are left justified.
NotSet The horizontal alignment is not set.
Right The contents of a container are right justified.
ID Gets or sets the programmatic identifier assigned to the server control.
PageCount Gets the number of pages required to display the records of the data source in a GridView control.
PageIndex Gets or sets the index of the currently displayed page.
PagerSettings Gets a reference to the PagerSettings object that allows you to set the properties of the pager buttons in a GridView control.
PagerStyle Gets a reference to the TableItemStyle object that allows you to set the appearance of the pager row in a GridView control.
PagerTemplate Gets or sets the custom content for the pager row in a GridView control.
PageSize Gets or sets the number of records to display on a page in a GridView control.
RowHeaderColumn Gets or sets the name of the column to use as the column header for the GridView control.
Rows Gets a collection of GridViewRow objects that represent the data rows in a GridView control.
Property Description
.Count Gets the number of items in the GridViewRowCollection object.
.Item(index) Gets a GridViewRow object at a specified index in the collection.
Property Description
.RowIndex Gets the index of the GridViewRow object.
.RowState Gets the state (Alternate, Edit, Insert, Normal) of the GridViewRow object.
.RowType Gets the type (DataRow, EmptyDataRow, Footer, Header, Pager, Separator) of the GridViewRow object.
RowStyle Gets a reference to the TableItemStyle object that allows you to set the appearance of the data rows in a GridView control.
SelectedDataKey Gets the DataKey object that contains the data key value for the selected row in a GridView control.
SelectedIndex Gets or sets the index of the selected row in a GridView control.
SelectedRow Gets a reference to a GridViewRow object that represents the selected row in the control.
SelectedRowStyle Gets a reference to the TableItemStyle object that allows you to set the appearance of the selected row in a GridView control.
SelectedValue Gets the data key value of the selected row in a GridView control.
ShowFooter Gets or sets a value indicating whether the footer row is displayed in a GridView control.
ShowHeader Gets or sets a value indicating whether the header row is displayed in a GridView control.
SortDirection Gets the sort direction of the column being sorted.
SortExpression Gets the sort expression associated with the column or columns being sorted.
TopPagerRow Gets a GridViewRow object that represents the top pager row in a GridView control.
UseAccessibleHeader Gets or sets a value indicating whether a GridView control renders its header in an accessible format. This property is provided to make the control more accessible to users of assistive technology devices.

Methods

Name Description
DeleteRow Deletes the record at the specified index from the data source.
IsBindableType Determines whether the specified data type can be bound to a column in a GridView control.
Sort Sorts the GridView control based on the specified sort expression and direction.
UpdateRow Updates the record at the specified row index using the field values of the row.

Events, Arguments, and Properties

Name Description
PageIndexChanged Occurs when one of the pager buttons is clicked, but after the GridView control handles the paging operation.
PageIndexChanging Occurs when one of the pager buttons is clicked, but before the GridView control handles the paging operation.
args As GridViewPageEventArgs
Name Description
.Cancel Gets or sets a value indicating whether the event should be canceled.
.NewPageIndex Gets or sets the index of the new page to display in the GridView control.
RowCancelingEdit Occurs when the Cancel button of a row in edit mode is clicked, but before the row exits edit mode.
args As GridViewCancelEditEventArgs
Name Description
.Cancel Gets or sets a value indicating whether the event should be canceled.
.RowIndex Gets the index of the row containing the Cancel button that raised the event.
RowCommand Occurs when a button is clicked in a GridView control.
args As GridViewCommandEventArgs
Name Description
.CommandArgument Gets the argument for the command.
.CommandName Gets the name of the command.
.CommandSource Gets the source of the command.
RowCreated Occurs when a row is created in a GridView control.
args As GridViewRowEventArgs
Name Description
.Row Gets the row being created.
RowDataBound Occurs when a data row is bound to data in a GridView control.
args As GridViewRowEventArgs
Name Description
.Row Gets the row being data-bound.
RowDeleted Occurs when a row’s Delete button is clicked, but after the GridView control deletes the row.
args As GridViewDeletedEventArgs
Name Description
.AffectedRows Gets the number of rows affected by the delete operation.
.Keys("name") Gets an ordered dictionary of key field name/value pairs for the deleted record.
.Values("name") Gets a dictionary of the non-key field name/value pairs for the deleted record.
RowDeleting Occurs when a row’s Delete button is clicked, but before the GridView control deletes the row.
args As GridViewDeleteEventArgs
Name Description
.Cancel Gets or sets a value indicating whether the event should be canceled.
.Keys("name") Gets a dictionary of field name/value pairs that represent the primary key of the row to delete.
.RowIndex Gets the index of the row being deleted.
.Values("name") Gets a dictionary of the non-key field name/value pairs in the row to delete.
RowEditing Occurs when a row’s Edit button is clicked, but before the GridView control enters edit mode.
args As GridViewEditEventArgs
Name Description
.Cancel Gets or sets a value indicating whether the event should be canceled.
.NewEditIndex Gets or sets the index of the row being edited.
RowUpdated Occurs when a row’s Update button is clicked, but after the GridView control updates the row. 
args As GridViewUpdatedEventArgs
Name Description
.AffectedRows Gets the number of rows affected by the update operation.
.Exception Gets the exception (if any) that was raised during the update operation.
.Keys("name") Gets a dictionary that contains the key field name/value pairs for the updated record.
.NewValues("name") Gets a dictionary that contains the new field name/value pairs for the updated record.
.OldValues("name") Gets a dictionary that contains the original field name/value pairs for the updated record.
RowUpdating Occurs when a row’s Update button is clicked, but before the GridView control updates the row.
args As GridViewUpdateEventArgs
Name Description
.Cancel Gets or sets a value indicating whether the event should be cancelled.
.Keys("name") Gets a dictionary of field name/value pairs that represent the primary key of the row to update.
.NewValues("name") Gets a dictionary containing the revised values of the non-key field name/value pairs in the row to update.
.OldValues("name") Gets a dictionary containing the original field name/value pairs in the row to update.
.RowIndex Gets the index of the row being updated.
SelectedIndexChanged Occurs when a row’s Select button is clicked, but after the GridView control handles the select operation.
SelectedIndexChanging Occurs when a row’s Select button is clicked, but before the GridView control handles the select operation.
args As GridViewSelectEventArgs
Name Description
.Cancel Gets or sets a value indicating whether the event should be cancelled.
.NewSelectedIndex Gets or sets the index of the new row to select in the GridView control.
Sorted Occurs when the hyperlink to sort a column is clicked, but after the GridView control handles the sort operation.
Sorting Occurs when the hyperlink to sort a column is clicked, but before the GridView control handles the sort operation.
args As GridViewSortEventArgs
Name Description
.Cancel Gets or sets a value indicating whether the event should be cancelled.
.SortDirection Gets or sets the direction in which to sort the GridView control.
.SortExpression Gets or sets the expression used to sort the items in the GridView control.

Top

HyperLink

 
<asp:HyperLink id="id" Runat="Server"
  ImageUrl="url"
  NavigateUrl="url"
  Target="_blank|_self|_search|_top|_parent|framename"
  Text="string"
    property="value"...
/>

Properties

Name Description
ID Gets or sets the programmatic identifier assigned to the server control.
ImageUrl Gets or sets the path to an image to display for the HyperLink control.
NavigateUrl Gets or sets the URL to link to when the HyperLink control is clicked.
Target Gets or sets the target window or frame in which to display the Web page content linked to when the HyperLink control is clicked.
Value Description
_blank Renders the content in a new window without frames.
_parent Renders the content in the immediate frameset parent.
_search Renders the content in the search pane.
_self Renders the content in the frame with focus.
_top Renders the content in the full window without frames.
framename Renders the content in a named frame in a frameset.
Text Gets or sets the text caption for the HyperLink control.

Top

HyperLinkField

 
<asp:HyperLinkField id="id" Runat="Server"
  DataNavigateUrlFields="field [,field]"
  DataNavigateUrlFormatString="{string}"
  DataTextField="field"
  DataTextFormatString="{string}"
  FooterText="string"
  HeaderImageUrl="url"
  HeaderText="string"
  InsertVisible="False|True"
  NavigateUrl="url"
  ShowHeader="False|True"
  SortExpression="field"
  Target="_blank|_parent|_search|_self|_top|framename"
  Text="string"
  
    FooterStyle-property="value"...
    HeaderStyle-property="value"...
    ItemStyle-property="value"...
    property="value"...
/>

Properties

Name Description
DataNavigateUrlFields Gets or sets the names of the fields from the data source used to construct the URLs for the hyperlinks in the HyperLinkField object.
DataNavigateUrlFormatString Gets or sets the string that specifies the format in which the URLs for the hyperlinks in a HyperLinkField object are rendered.
DataTextField Gets or sets the name of the field from the data source containing the text to display for the hyperlink captions in the HyperLinkField object.
DataTextFormatString Get or sets the string that specifies the format in which the hyperlink captions in a HyperLinkField object are displayed.
FooterStyle Gets or sets the style of the footer of the data control field.
FooterText Gets or sets the text that is displayed in the footer item of a data control field.
HeaderImageUrl Gets or sets the URL of an image that is displayed in the header item of a data control field.
HeaderStyle Gets or sets the style of the header of the data control field.
HeaderText Gets or sets the text that is displayed in the header item of a data control field.
InsertVisible Gets a value indicating whether the DataControlField object is visible when its parent data-bound control is in insert mode.
ItemStyle Gets the style of any text-based content displayed by a data control field.
NavigateUrl Gets or sets the URL to navigate to when a hyperlink in a HyperLinkField object is clicked.
ShowHeader Gets or sets a value indicating whether the header item of a data control field is rendered.
SortExpression Gets or sets a sort expression that is used by a data source control to sort data.
Target Gets or sets the target window or frame in which to display the Web page linked to when a hyperlink in a HyperLinkField object is clicked.
Value Description
_blank Renders the content in a new window without frames.
_parent Renders the content in the immediate frameset parent.
_search Renders the content in the search pane.
_self Renders the content in the frame with focus.
_top Renders the content in the full window without frames.
framename Renders the content in a named frame in a frameset.
Text Gets or sets the text to display for each hyperlink in the HyperLinkField object.

Top

Image

 
<asp:Image id="id" Runat="Server"
  AlternateText="string"
  DescriptionUrl="url"
  GenerateEmptyAlternateText="False|True"
  ImageAlign="Bottom|Left|Middle|Right|Top|TextTop|AbsBottom|AbsMiddle|
              AbsBaseLine|NotSet"
  ImageURL="url"
    property="value"...
/>

Properties

Name Description
AlternateText Gets or sets the alternate text displayed in the Image control when the image is unavailable. Browsers that support the ToolTips feature display this text as a ToolTip.
DescriptionUrl Gets or sets the location to a detailed description for the image.
GenerateEmptyAlternateText Gets or sets a value indicating whether the control generates an alternate text attribute for an empty string value.
ID Gets or sets the programmatic identifier assigned to the server control.
ImageAlign Gets or sets the alignment of the Image control in relation to other elements on the Web page.
Value Description
AbsBottom The lower edge of the image is aligned with the lower edge of the largest element on the same line.
AbsMiddle The middle of the image is aligned with the middle of the largest element on the same line.
BaseLine The lower edge of the image is aligned with the lower edge of the first line of text.
Bottom The lower edge of the image is aligned with the lower edge of the first line of text.
Left The image is aligned on the left edge of the Web page with text wrapping on the right.
Middle The middle of the image is aligned with the lower edge of the first line of text.
NotSet The alignment is not set.
Right The image is aligned on the right edge of the Web page with text wrapping on the left.
TextTop The upper edge of the image is aligned with the upper edge of the highest text on the same line.
Top The upper edge of the image is aligned with the upper edge of the highest element on the same line.
ImageUrl Gets or sets the location of an image to display in the Image control.

Top

ImageButton

 
<asp:ImageButton id="id" Runat="Server"
  AlternateText="string"
  CausesValidation="False|True"
  CommandArgument="string"
  CommandName="string"
  DescriptionUrl="url"
  GenerateEmptyAlternateText="False|True"
  ImageAlign="Bottom|Left|Middle|Right|Top|TextTop
              AbsBottom|AbsMiddle|AbsBaseLine|NotSet"
  ImageUrl="url"
  OnClientClick="subprogram"
  PostBackUrl="url"
  ValidationGroup="name"
  
    property="value"...
  
    OnClick="subprogram"
    OnCommand="subprogram"
/>

Properties

Name Description
AlternateText Gets or sets the alternate text displayed in the Image control when the image is unavailable. Browsers that support the ToolTips feature display this text as a ToolTip.
CausesValidation Gets or sets a value indicating whether validation is performed when the ImageButton control is clicked.
CommandArgument Gets or sets an optional argument that provides additional information about the CommandName property.
CommandName Gets or sets the command name associated with the ImageButton control.
DescriptionUrl Gets or sets the location to a detailed description for the image.
GenerateEmptyAlternateText Gets or sets a value indicating whether the control generates an alternate-text attribute for an empty string value.
ID Gets or sets the programmatic identifier assigned to the server control.
ImageAlign Gets or sets the alignment of the Image control in relation to other elements on the Web page.
Value Description
AbsBottom The lower edge of the image is aligned with the lower edge of the largest element on the same line.
AbsMiddle The middle of the image is aligned with the middle of the largest element on the same line.
BaseLine The lower edge of the image is aligned with the lower edge of the first line of text.
Bottom The lower edge of the image is aligned with the lower edge of the first line of text.
Left The image is aligned on the left edge of the Web page with text wrapping on the right.
Middle The middle of the image is aligned with the lower edge of the first line of text.
NotSet The alignment is not set.
Right The image is aligned on the right edge of the Web page with text wrapping on the left.
TextTop The upper edge of the image is aligned with the upper edge of the highest text on the same line.
Top The upper edge of the image is aligned with the upper edge of the highest element on the same line.
ImageUrl Gets or sets the location of an image to display in the Image control.
OnClientClick Gets or sets the client-side script that executes when an ImageButton control’s Click event is raised.
PostBackUrl Gets or sets the URL of the page to post to from the current page when the ImageButton control is clicked.
ValidationGroup Gets or sets the group of controls for which the ImageButton control causes validation when it posts back to the server.

Events and Arguments

Name Description
Click Occurs when the ImageButton control is clicked.
args As EventArgs
Command Occurs when the ImageButton control is clicked.
args As CommandEventArgs
Property Description
.CommandArgument Gets the value associated the button's CommandArgument.
.CommandName Gets the value associated the button's CommandName.

Top

ImageField

 
<asp:ImageField id="id" Runat="Server"
  AlternateText="string"
  ConvertEmptyStringToNull="False|True"
  DataAlternateTextField="field"
  DataAlternateTextFormatString="{string}"
  DataImageUrlFormatString="{string}"
  FooterText="string"
  HeaderImageUrl="url"
  HeaderText="string"
  InsertVisible="False|True"
  NullDisplayText="string"
  NullImageUrl="url"
  ReadOnly="False|True"
  ShowHeader="False|True"
  SortExpression="field"
  
    FooterStyle-property="value"...
    HeaderStyle-property="value"...
    ItemStyle-property="value"...
    property="value"...
/>

Properties

Name Description
AlternateText Gets or sets the alternate text displayed for an image in the ImageField object.
ConvertEmptyStringToNull Gets or sets a value indicating whether empty string (“”) values are converted to a null reference (Nothing in Visual Basic) when the field values are returned from the data source.
DataAlternateTextField Gets or sets the name of the field from the data source that contains the values to bind to the AlternateText property of each image in an ImageField object.
DataAlternateTextFormatString Gets or sets the string that specifies the format in which the alternate text for each image in an ImageField object is rendered.
DataImageUrlField Gets or sets the name of the field from the data source that contains the values to bind to the ImageUrl property of each image in an ImageField object.
DataImageUrlFormatString Gets or sets the string that specifies the format in which the URL for each image in an ImageField object is rendered.
FooterStyle Gets or sets the style of the footer of the data control field.
FooterText Gets or sets the text that is displayed in the footer item of a data control field.
HeaderImageUrl Gets or sets the URL of an image that is displayed in the header item of a data control field.
HeaderStyle Gets or sets the style of the header of the data control field.
HeaderText Gets or sets the text that is displayed in the header item of a data control field.
InsertVisible Gets a value indicating whether the DataControlField object is visible when its parent data-bound control is in insert mode.
ItemStyle Gets the style of any text-based content displayed by a data control field.
NullDisplayText Gets or sets the text to display in an ImageField object when the value of the field specified by the DataImageUrlField property is a null reference (Nothing in Visual Basic).
NullImageUrl Gets or sets the URL to an alternate image displayed in an ImageField object when the value of the field specified by the DataImageUrlField property is a null reference (Nothing in Visual Basic).
ReadOnly Gets or sets a value indicating whether the values of the field specified by the DataImageUrlField property can be modified in edit mode.
ShowHeader Gets or sets a value indicating whether the header item of a data control field is rendered.
SortExpression Gets or sets a sort expression that is used by a data source control to sort data.

Top

ImageMap

 
<asp:ImageMap id="id" Runat="Server"
  AlternateText="string"
  DescriptionUrl="url"
  GenerateEmptyAlternateText="False|True"
  HotSpotMode="Inactive|NotSet|Navigate|PostBack"
  ImageAlign="Bottom|Left|Middle|Right|Top|TextTop
              AbsBottom|AbsMiddle|AbsBaseLine|NotSet"
  ImageUrl="url"
  Target="_blank|_parent|_search|_self|_top|framename"

    property="value"...

    OnClick="subprogram"
>
  
  <asp:CircleHotSpot
    AlternateText="string"
    HotSpotMode="NotSet|Inactive|Navigate|PostBack"
    NavigateUrl="url"
    PostBackValue="string"
    Radius="n"
    X="n"
    Y="n"
    Target="_blank|_parent|_search|_self|_top|framename"
  />
  
  <asp:PolygonHotSpot
    AlternateText="string"
    Coordinates="string"
    HotSpotMode="NotSet|Inactive|Navigate|PostBack"
    NavigateUrl="url"
    PostBackValue="string"
    Target="_blank|_parent|_search|_self|_top|framename"
  />
  
  <asp:RectangleHotSpot
    AlternateText="string"
    Left="n"
    Top="n"
    Right="n"
    Bottom="n"
    HotSpotMode="NotSet|Inactive|Navigate|PostBack"
    NavigateUrl="url"
    PostBackValue="string"
    Target="_blank|_parent|_search|_self|_top|framename"
  />
	
</asp:ImageMap>

Properties

Name Description
AlternateText Gets or sets the alternate text displayed in the Image control when the image is unavailable. Browsers that support the ToolTips feature display this text as a ToolTip.
DescriptionUrl Gets or sets the location to a detailed description for the image.
GenerateEmptyAlternateText Gets or sets a value indicating whether the control generates an alternate text attribute for an empty string value.
HotSpots Gets a collection of HotSpot objects that represents the defined hot spot regions in an ImageMap control.
Property Description
.Count Gets the number of HotSpot objects in the collection.
.Item(index) Gets a HotSpot object at a specified index in the collection.
Property Description
.property Gets or sets a property of the HotSpot object.
HotSpotMode Gets or sets the default behavior for the HotSpot objects of an ImageMap control when the HotSpot objects are clicked.
Value Description
Inactive The HotSpot does not have any behavior.
Navigate The HotSpot navigates to a URL.
NotSet The HotSpot uses the behavior set by the ImageMap control's HotSpotMode property. If the ImageMap control does not define the behavior, the HotSpot object navigates to a URL.
PostBack The HotSpot generates a postback to the server.
ID Gets or sets the programmatic identifier assigned to the server control.
ImageAlign Gets or sets the alignment of the Image control in relation to other elements on the Web page.
Value Description
AbsBottom The lower edge of the image is aligned with the lower edge of the largest element on the same line.
AbsMiddle The middle of the image is aligned with the middle of the largest element on the same line.
BaseLine The lower edge of the image is aligned with the lower edge of the first line of text.
Bottom The lower edge of the image is aligned with the lower edge of the first line of text.
Left The image is aligned on the left edge of the Web page with text wrapping on the right.
Middle The middle of the image is aligned with the lower edge of the first line of text.
NotSet The alignment is not set.
Right The image is aligned on the right edge of the Web page with text wrapping on the left.
TextTop The upper edge of the image is aligned with the upper edge of the highest text on the same line.
Top The upper edge of the image is aligned with the upper edge of the highest element on the same line.
ImageUrl Gets or sets the location of an image to display in the Image control.
Target Gets or sets the target window or frame that displays the Web page content linked to when the ImageMap control is clicked.
Value Description
_blank Renders the content in a new window without frames.
_parent Renders the content in the immediate frameset parent.
_search Renders the content in the search pane.
_self Renders the content in the frame with focus.
_top Renders the content in the full window without frames.

Events, Arguments, and Properties

Name Description
Click Occurs when a HotSpot object in an ImageMap control is clicked.
args As ImageMapEventArgs
Name Description
.PostBackValue Gets the string assigned to the PostBackValue property of the HotSpot object that was clicked.

Top

CircleHotSpot

 
<asp:CircleHotSpot
  AlternateText="string"
  HotSpotMode="NotSet|Inactive|Navigate|PostBack"
  NavigateUrl="url"
  PostBackValue="string"
  Radius="n"
  X="n"
  Y="n"
  Target="_blank|_parent|_search|_self|_top|framename"
/>

Properties

Name Description
AlternateText Gets or sets the alternate text to display for a HotSpot object in an ImageMap control when the image is unavailable or renders to a browser that does not support images.
HotSpotMode Gets or sets the behavior of a HotSpot object in an ImageMap control when the HotSpot is clicked.
Value Description
NotSet The HotSpot uses the behavior set by the ImageMap control’s HotSpotMode property. If the ImageMap control does not define the behavior, the HotSpot objects navigate to a URL.
Inactive The HotSpot does not have any behavior.
Navigate The HotSpot navigates to a URL.
PostBack The HotSpot generates a postback to the server.
NavigateUrl Gets or sets the URL to navigate to when a HotSpot object is clicked.
PostBackValue Gets or sets the name of the HotSpot object to pass in the event data when the HotSpot is clicked.
Radius Gets or sets the distance from the center to the edge of the circular region defined by this CircleHotSpot object.
Target Gets or sets the target window or frame in which to display the Web page content linked to when a HotSpot object that navigates to a URL is clicked.
Value Description
_blank Renders the content in a new window without frames.
_parent Renders the content in the immediate frameset parent.
_search Renders the content in the search pane.
_self Renders the content in the frame with focus.
_top Renders the content in the full window without frames.
X Gets or sets the x-coordinate of the center of the circular region defined by this CircleHotSpot object.
Y Gets or sets the y-coordinate of the center of the circular region defined by this CircleHotSpot object.

Top

PolygonHotSpot

 
<asp:PolygonHotSpot
  AlternateText="string"
  Coordinates="string"
  HotSpotMode="NotSet|Inactive|Navigate|PostBack"
  NavigateUrl="url"
  PostBackValue="string"
  Target="_blank|_parent|_search|_self|_top|framename"
/>

Properties

Name Description
AlternateText Gets or sets the alternate text to display for a HotSpot object in an ImageMap control when the image is unavailable or renders to a browser that does not support images.
Coordinates A string of coordinates that represents the vertexes of a PolygonHotSpot object.
HotSpotMode Gets or sets the behavior of a HotSpot object in an ImageMap control when the HotSpot is clicked.
Mode Description
NotSet The HotSpot uses the behavior set by the ImageMap control’s HotSpotMode property. If the ImageMap control does not define the behavior, the HotSpot objects navigate to a URL.
Inactive The HotSpot does not have any behavior.
Navigate The HotSpot navigates to a URL.
PostBack The HotSpot generates a postback to the server.
NavigateUrl Gets or sets the URL to navigate to when a HotSpot object is clicked.
PostBackValue Gets or sets the name of the HotSpot object to pass in the event data when the HotSpot is clicked.
Target Gets or sets the target window or frame in which to display the Web page content linked to when a HotSpot object that navigates to a URL is clicked.
Value Description
_blank Renders the content in a new window without frames.
_parent Renders the content in the immediate frameset parent.
_search Renders the content in the search pane.
_self Renders the content in the frame with focus.
_top Renders the content in the full window without frames.

Top

RectangleHotSpot

 
<asp:RectangleHotSpot
  AlternateText="string"
  Left="n"
  Top="n"
  Right="n"
  Bottom="n"
  HotSpotMode="NotSet|Inactive|Navigate|PostBack"
  NavigateUrl="url"
  PostBackValue="string"
  Target="_blank|_parent|_search|_self|_top|framename"
/>

Properties

Name Description
AlternateText Gets or sets the alternate text to display for a HotSpot object in an ImageMap control when the image is unavailable or renders to a browser that does not support images.
Bottom Gets or sets the y-coordinate of the bottom side of the rectangular region defined by this RectangleHotSpot object.
HotSpotMode Gets or sets the behavior of a HotSpot object in an ImageMap control when the HotSpot is clicked.
Mode Description
NotSet The HotSpot uses the behavior set by the ImageMap control’s HotSpotMode property. If the ImageMap control does not define the behavior, the HotSpot objects navigate to a URL.
Inactive The HotSpot does not have any behavior.
Navigate The HotSpot navigates to a URL.
PostBack The HotSpot generates a postback to the server.
Left Gets or sets the x-coordinate of the left side of the rectangular region defined by this RectangleHotSpot object.
NavigateUrl Gets or sets the URL to navigate to when a HotSpot object is clicked.
PostBackValue Gets or sets the name of the HotSpot object to pass in the event data when the HotSpot is clicked.
Right Gets or sets the x-coordinate of the right side of the rectangular region defined by this RectangleHotSpot object.
Target Gets or sets the target window or frame in which to display the Web page content linked to when a HotSpot object that navigates to a URL is clicked.
Value Description
_blank Renders the content in a new window without frames.
_parent Renders the content in the immediate frameset parent.
_search Renders the content in the search pane.
_self Renders the content in the frame with focus.
_top Renders the content in the full window without frames.
Top Gets or sets the y-coordinate of the top side of the rectangular region defined by this RectangleHotSpot object.

Top

Label

 
<asp:Label id="id" Runat="Server"
  Text="string"

    property="value"...
/>

Properties

Name Description
ID Gets or sets the programmatic identifier assigned to the server control.
Text Gets or sets the text content of the Label control.

Top

LinkButton

 
<asp:LinkButton id="id" Runat="Server"
  CausesValidation="True|False"
  CommandArgument="argument"
  CommandName="command"
  OnClientClick="client subprogram"
  PostBackUrl="url"
  Text="string"
  ValidationGroup="name"
    
    property="value"...
    
    OnClick="subprogram"
    OnCommand="subprogram"
/>

Properties

Name Description
CausesValidation Gets or sets a value indicating whether validation is performed when the LinkButton control is clicked.
CommandArgument Gets or sets an optional argument passed to the Command event handler along with the associated CommandName property.
CommandName Gets or sets the command name associated with the LinkButton control. This value is passed to the Command event handler along with the CommandArgument property.
ID Gets or sets the programmatic identifier assigned to the server control.
OnClientClick Gets or sets the client-side script that executes when a LinkButton control’s Click event is raised.
PostBackUrl Gets or sets the URL of the page to post to from the current page when the LinkButton control is clicked.
Text Gets or sets the text caption displayed on the LinkButton control.
ValidationGroup Gets or sets the group of controls for which the LinkButton control causes validation when it posts back to the server.
Name Description
Click Occurs when the LinkButton control is clicked.
args As EventArgs
Command Occurs when the LinkButton control is clicked.
args As CommandEventArgs
Property Description
.CommandName Gets the value associated the button's CommandName.
.CommandArgument Gets the value associated the button's CommandArgument.

Top

ListBox

 
<asp:ListBox id="id" Runat="Server"
  AutoPostBack="True|False"
  CausesValidation="True|False"
  DataSourceID="id"
  DataTextField="field"
  DataTextFormatString="{string}"
  DataValueField="field"
  Rows="n"
  SelectionMode="Multiple|Single"
  ValidationGroup="name"

    property="value"...

    OnSelectedIndexChanged="subprogram"
>

  <asp:ListItem
    Selected="False|True"
    Text="string"
    Value="value"
  />
  ...

</asp:ListBox>

Properties

Name Description
AutoPostBack Gets or sets a value indicating whether a postback to the server automatically occurs when the user changes the list selection.
CausesValidation Gets or sets a value indicating whether validation is performed when a control that is derived from the ListControl class is clicked.
DataSourceID Gets or sets the ID of the control from which the data-bound control retrieves its list of data items.
DataTextField Gets or sets the field of the data source that provides the text content of the list items.
DataTextFormatString Gets or sets the formatting string used to control how data bound to the list control is displayed.
DataValueField Gets or sets the field of the data source that provides the value of each list item.
ID Gets or sets the programmatic identifier assigned to the server control.
Items Gets the collection of ListItems in the list control.
Property Description
.Count Gets the number of ListItem objects in the collection.
.(index) Gets a ListItem object at a specified index in the collection.
Property Description
.Selected Gets or sets whether the ListItem is selected.
.Text Gets or sets the text displayed in the ListItem.
.Value Gets or sets the value associated with the ListItem.
Method Description
.Clear() Clear all items from a ListItem collection.
.FindByText("text")
Searches the collection for a ListItem with a Text property that contains the specified value.
.FindByValue("value")
Searches the collection for a ListItem with a Value property that contains the specified value.
.RemoveAt(index) Remove an item from the ListItem at the index location in the collection.
.Add(New ListItem("text","value"))
Add a new ListItem next in order in the collection.
.Insert(index, New ListItem("text","value"))
Add a new ListItem at the index location in the collection.
Rows Gets or sets the number of rows displayed in the ListBox control.
SelectedIndex Gets or sets the lowest ordinal index of the selected items in the list.
SelectedItem Gets the selected item with the lowest index in the list control.
SelectedValue Gets the value of the selected item in the list control, or selects the item in the list control that contains the specified value.
SelectionMode Gets or sets the selection mode of the ListBox control.
Mode Description
Single Single item selection.
Multiple Multiple item selections.
Text Gets or sets the SelectedValue property of the ListControl control.
ValidationGroup Gets or sets the group of controls for which the control that is derived from the ListControl class causes validation when it posts back to the server.

Methods

Name Description
ClearSelection Clears out the list selection and sets the Selected property of all items to false.
GetSelectedIndices Gets the array of index values for currently selected items in the ListBox control.

Events and Arguments

Name Description
SelectedIndexChanged Occurs when the selection from the list control changes between posts to the server.
args As EventArgs
Property Description
ListBox.SelectedIndex Gets or sets the lowest index of the selected items in the list.
ListBox.SelectedItem Gets the selected item with the lowest index in the list control.
ListBox.SelectedValue Gets the value of the selected item with the lowest index in the list control, or selects the item in the list control that contains the specified value.

Top

Menu

 
<asp:Menu id="id" Runat="Server"
  DataSourceID="id"
  DisappearAfter="milliseconds"
  DynamicBottomSeparatorImageUrl="url"
  DynamicEnableDefaultPopOutImage="False|True"
  DynamicHorizontalOffset="n"
  DynamicItemFormatString="string"
  DynamicPopOutImageTextFormatString="string"
  DynamicPopOutImageUrl="url"
  DynamicTopSeparatorImageUrl="url"
  DynamicVerticalOffset="n"
  ItemWrap="False|True"
  MaximumDynamicDisplayLevels="n"
  Orientation="Horizontal|Vertical"
  ScrollDownImageUrl="url"
  ScrollDownText="string"
  ScrollUpImageUrl="url"
  ScrollUpText="string"
  StaticBottomSeparatorImageUrl="url"
  StaticDisplayLevels="n"
  StaticEnableDefaultPopOutImage="False|True"
  StaticItemFormatString="string"
  StaticPopOutImageTextFormatString="string"
  StaticPopOutImageUrl="url"
  StaticSubMenuIndent="n"
  StaticTopSeparatorImageUrl="url"
  Target="_blank|_parent|_search|_self|_top|framename"
	
    DynamicHoverStyle-property="value"...
    DynamicMenuItemStyle-property="value"...
    DynamicSelectedStyle-property="value"...
    DynamicMenuStyle-property="value"...
    StaticHoverStyle-property="value"...
    StaticMenuStyle-property="value"...
    StaticMenuItemStyle-property="value"...
    StaticSelectedStyle-property="value"...
>
	
  <Items>
	
    <asp:MenuItem
      DataItem="field"
      DataPath="path"
      ImageUrl="url"
      NavigateUrl="url"
      PopOutImageUrl="url"
      Selectable="False|True"
      Selected="False|True"
      SeparatorImageUrl="url"
      Target="_blank|_parent|_search|_self|_top|framename"
      Text="string"
      Value="string"
      ValuePath="path"
    />
		
  </Items>
	
  <DataBindings>

    <asp:MenuItemBinding
      FormatString="{string}"
      ImageUrl="url"
      ImageUrlField="field"
      NavigateUrl="url"
      NavigateUrlField="field"
      PopOutImageUrl="url"
      PopOutImageUrlField="field"
      Selectable="False|True"
      SelectableField="field"
      SeparatorImageUrl="url"
      SeparatorImageUrlField="field"
      Target="_blank|_parent|_search|_self|_top|framename"
      TargetField="field"
      Text="string"
      TextField="field"
      Value="string"
      ValueField="field"
    />

  </DataBindings>

</asp:Menu>

Properties

Name Description
DataSourceID Gets or sets the ID of the control from which the data-bound control retrieves its list of data items.
DisappearAfter Gets or sets the duration for which a dynamic menu is displayed after the mouse pointer is no longer positioned over the menu.
DynamicBottomSeparatorImageUrl Gets or sets the URL to an image to display at the bottom of each dynamic menu item to separate it from other menu items.
DynamicEnableDefaultPopOutImage Gets or sets a value indicating whether the built-in image that indicates that a dynamic menu item has a submenu is displayed.
DynamicHorizontalOffset Gets or sets the number of pixels to shift a dynamic menu horizontally relative to its parent menu item.
DynamicHoverStyle Gets a reference to the Style object that allows you to set the appearance of a dynamic menu item when the mouse pointer is positioned over it.
DynamicItemFormatString Gets or sets additional text shown with all menu items that are dynamically displayed.
DynamicItemTemplate Gets or sets the template that contains the custom content to render for a dynamic menu.
DynamicMenuItemStyle Gets a reference to the MenuItemStyle object that allows you to set the appearance of the menu items within a dynamic menu.
DynamicMenuStyle Gets a reference to the MenuItemStyle object that allows you to set the appearance of a dynamic menu.
DynamicPopOutImageTextFormatString Gets or sets the alternate text for the image used to indicate that a dynamic menu item has a submenu.
DynamicPopOutImageUrl Gets or sets the URL to a custom image that is displayed in a dynamic menu item when the dynamic menu item has a submenu.
DynamicSelectedStyle Gets a reference to the MenuItemStyle object that allows you to set the appearance of the dynamic menu item selected by the user.
DynamicTopSeparatorImageUrl Gets or sets the URL to an image to display at the top of each dynamic menu item to separate it from other menu items.
DynamicVerticalOffset Gets or sets the number of pixels to shift a dynamic menu vertically relative to its parent menu item.
ID Gets or sets the programmatic identifier assigned to the server control.
Items Gets a MenuItemCollection object that contains all menu items in the Menu control.
Property Description
.Count Gets the number of MenuItem objects in the collection.
.(index) Gets a MenuItem object at a specified index in the collection.
Method Description
.Clear() Removes all items from a MenuItem collection.
.RemoveAt(index) Removes the specified MenuItem object from the collection.
.ChildItems.Add(New MenuItem("text"))
Add a new MenuItem next in order in the collection.
.ChildItems.Insert(index, New MenuItem("text")
Add a new MenuItem at the index location in the collection.
ItemWrap Gets or sets a value indicating whether the text for menu items should wrap.
LevelMenuItemStyles Gets a MenuItemStyleCollection object that contains the style settings that are applied to menu items based on their level in a Menu control.
LevelSelectedStyles Gets a MenuItemStyleCollection object that contains the style settings that are applied to the selected menu item based on its level in a Menu control.
LevelSubMenuStyles Gets a MenuItemStyleCollection object that contains the style settings that are applied to the submenu items in the static menu based on their level in a Menu control.
MaximumDynamicDisplayLevels Gets or sets the number of menu levels to render for a dynamic menu.
Orientation Gets or sets the direction in which to render the Menu control.
Value Description
Horizontal Lays out the elements of the control in a horizontal manner.
Vertical Lays out the elements of the control in a vertical manner.
ScrollDownImageUrl Gets or sets the URL to an image displayed in a dynamic menu to indicate that the user can scroll down for additional menu items.
ScrollDownText Gets or sets the alternate text for the image specified in the ScrollDownImageUrl property.
ScrollUpImageUrl Gets or sets the URL to an image displayed in a dynamic menu to indicate that the user can scroll up for additional menu items.
ScrollUpText Gets or sets the alternate text for the image specified in the ScrollUpImageUrl property.
SelectedItem Gets the selected menu item.
SelectedValue Gets the value of the selected menu item.
StaticBottomSeparatorImageUrl Gets or sets the URL to an image displayed as the separator at the bottom of each static menu item.
StaticDisplayLevels Gets or sets the number of menu levels to display in a static menu.
StaticEnableDefaultPopOutImage Gets or sets a value indicating whether the built-in image is displayed to indicate that a static menu item has a submenu.
StaticHoverStyle Gets a reference to the Style object that allows you to set the appearance of a static menu item when the mouse pointer is positioned over it.
StaticItemFormatString Gets or sets additional text shown with all menu items that are statically displayed.
StaticItemTemplate Gets or sets the template that contains the custom content to render for a static menu.
StaticMenuItemStyle Gets a reference to the MenuItemStyle object that allows you to set the appearance of the menu items in a static menu.
StaticMenuStyle Gets a reference to the MenuItemStyle object that allows you to set the appearance of a static menu.
StaticPopOutImageTextFormatString Gets or sets the alternate text for the pop-out image used to indicate that a static menu item has a submenu.
StaticPopOutImageUrl Gets or sets the URL to an image displayed to indicate that a static menu item has a submenu.
StaticSelectedStyle Gets a reference to the MenuItemStyle object that allows you to set the appearance of the menu item selected by the user in a static menu.
StaticSubMenuIndent Gets or sets the amount of space, in pixels, to indent submenus within a static menu.
StaticTopSeparatorImageUrl Gets or sets the URL to an image displayed as the separator at the top of each static menu item.
Target Gets or sets the target window or frame in which to display the Web page content associated with a menu item.
Value Description
_blank Renders the content in a new window without frames.
_parent Renders the content in the immediate frameset parent.
_search Renders the content in the search pane.
_self Renders the content in the frame with focus.
_top Renders the content in the full window without frames.

Methods

Name Description
FindItem Retrieves the menu item at the specified value path.

Events and Arguments

Name Description
MenuItemClick Occurs when a menu item in a Menu control is clicked.
args As MenuEventArgs
Name Description
.CommandArgument Gets the argument for the command.
.CommmandName Gets the name for the command.
.CommandSource Gets the object that raised the event.
.Item Gets the menu item associated with the event raised.
MenuItemDataBound Occurs when a menu item in a Menu control is bound to data.

Top

MenuItem

 
<asp:MenuItem
  DataItem="field"
  DataPath="path"
  ImageUrl="url"
  NavigateUrl="url"
  PopOutImageUrl="url"
  Selectable="False|True"
  Selected="False|True"
  SeparatorImageUrl="url"
  Target="_blank|_parent|_search|_self|_top|framename"
  Text="string"
  Value="string"
  ValuePath="path"
/>

Properties

Name Description
ChildItems Gets a MenuItemCollection object that contains the submenu items of the current menu item.
DataBound Gets a value indicating whether the menu item was created through data binding.
DataItem Gets the data item that is bound to the menu item.
DataPath Gets the path to the data that is bound to the menu item.
Depth Gets the level at which a menu item is displayed.
ImageUrl Gets or sets the URL to an image that is displayed next to the text in a menu item.
NavigateUrl Gets or sets the URL to navigate to when the menu item is clicked.
PopOutImageUrl Gets or sets the URL to an image that is displayed in a menu item to indicate that the menu item has a dynamic submenu.
Selectable Gets or sets a value that indicates whether the MenuItem object can be selected, or is “clickable.”
Selected Gets or sets a value indicating whether the current menu item is selected in a Menu control.
SeparatorImageUrl Gets or sets the URL to an image displayed at the bottom of a menu item to separate it from other menu items.
Target Gets or sets the target window or frame in which to display the Web page content associated with a menu item.
Value Description
_blank Renders the content in a new window without frames.
_parent Renders the content in the immediate frameset parent.
_search Renders the content in the search pane.
_self Renders the content in the frame with focus.
_top Renders the content in the full window without frames.
Text Gets or sets the text displayed for the menu item in a Menu control.
ToolTip Gets or sets the ToolTip text for the menu item.
Value Gets or sets a non-displayed value used to store any additional data about the menu item, such as data used for handling postback events.
ValuePath Gets the path from the root menu item to the current menu item.

Top

MultiView

 
<asp:MultiView id="id" Runat="Server"
  ActiveViewIndex="viewindex"
>
	
  <asp:View id="id" Runat="Server"
	
    ...Controls, text, and XHTML
	
  </asp:View>
  ...
	
</asp:MultiView>

Properties

Name Description
ActiveViewIndex Gets or sets the index of the active View control within a MultiView control.
ID Gets or sets the programmatic identifier assigned to the server control.
Views Gets the collection of View controls in the MultiView control.

Methods

Name Description
GetActiveView Returns the current active View control within a MultiView control.
SetActiveView Sets the specified View control to the active view within a MultiView control.

Events and Arguments

Name Description
ActiveViewChanged Occurs when the active View control of a MultiView control changes between posts to the server.
args As EventArgs

Top

ObjectDataSource

 
<asp:ObjectDataSource id="id" Runat="Server"
  DeleteMethod="method"
  InsertMethod="method"
  SelectMethod="method"
  UpdateMethod="Method"
  TypeName="class"
>
  
</asp:ObjectDataSource>

Properties

Name Description
DeleteMethod Gets or sets the name of the method or function that the ObjectDataSource control invokes to delete data.
InsertMethod Gets or sets the name of the method or function that the ObjectDataSource control invokes to insert data.
SelectMethod Gets or sets the name of the method or function that the ObjectDataSource control invokes to retrieve data.
UpdateMethod Gets or sets the name of the method or function that the ObjectDataSource control invokes to update data.
TypeName Gets or sets the name of the class that the ObjectDataSource object represents.

Top

PagerSettings

 
<asp:PagerSettings
  FirstPageImageUrl="url"
  FirstPageText="string"
  LastPageImageUrl="url"
  LastPageText="string"
  Mode="NextPrevious|NextPreviousFirstLast|Numeric|NumericFirstLast"
  NextPageImageUrl="url"
  NextPageText="string"
  PageButtonCount="n"
  Position="Bottom|Top|TopAndBottom"
  PreviousPageImageUrl="url"
  PreviousPageText="string"
/>

Properties

Name Description
FirstPageImageUrl Gets or sets the URL to an image to display for the first-page button.
FirstPageText Gets or sets the text to display for the first-page button.
LastPageImageUrl Gets or sets the URL to an image to display for the last-page button.
LastPageText Gets or sets the text to display for the last-page button.
Mode Gets or sets the mode in which to display the pager controls in a control that supports pagination.
Mode Description
NextPrevious Previous-page and next-page buttons.
NextPreviousFirstLast Previous-page, next-page, first-page, and last-page buttons.
Numeric Numbered link buttons to access pages directly.
NumericFirstLast Numbered and first-link and last-link buttons.
NextPageImageUrl Gets or sets the URL to an image to display for the next-page button.
NextPageText Gets or sets the text to display for the next-page button.
PageButtonCount Gets or sets the number of page buttons to display in the pager when the Mode property is set to the Numeric or NumericFirstLast value.
Position Gets or sets a value that specifies the location where the pager is displayed.
Position Description
Bottom The bottom of the control.
Top The top of the control.
TopAndBottom At both the top and bottom of the control.
PreviousPageImageUrl Gets or sets the URL to an image to display for the previous-page button.
PreviousPageText Gets or sets the text to display for the previous page button.

Top

Panel

 
<asp:Panel id="id" Runat="Server"
  BackImageUrl="url"
  HorizontalAlign="Center|Justify|Left|NotSet|Right"
  ScrollBars="Auto|Horizontal|Vertical|Both|None"
  Wrap="False|True"
    property="value"...
>

  ...XHTML, text, and server controls
		
</asp:Panel>

Properties

Name Description
BackImageUrl Gets or sets the URL of the background image for the panel control.
ID Gets or sets the programmatic identifier assigned to the server control.
ScrollBars Gets or sets the visibility and position of scroll bars in a Panel control.
Value Description
None No scroll bars are shown.
Horizontal Only a horizontal scroll bar is shown.
Vertical Only a vertical scroll bar is shown.
Both Both horizontal and vertical scroll bars are shown.
Auto If necessary, horizontal, vertical, or both scroll bars are shown. Otherwise, no scroll bars are shown.
Wrap Gets or sets a value indicating whether the content wraps within the panel.

Top

PlaceHolder

 
<asp:PlaceHolder id="id" Runat="Server"/>

Top

RadioButton

 
<asp:RadioButton id="id" Runat="Server"
  AutoPostBack="False|True"
  CausesValidation="False|True"
  Checked="False|True"
  GroupName="name"
  Text="string"
  TextAlign="Left|Right"
  ValidationGroup="name"
  
    property="value"...
  
    OnCheckedChanged="subprogram"
/>

Properties

Name Description
AutoPostBack Gets or sets a value indicating whether the RadioButton state automatically posts back to the server when clicked.
CausesValidation Gets or sets a value indicating whether validation is performed when the RadioButton control is clicked.
Checked Gets or sets a value indicating whether the RadioButton control is checked.
GroupName Gets or sets the name of the group that the radio button belongs to.
ID Gets or sets the programmatic identifier assigned to the server control.
Text Gets or sets the text label associated with the radio button.
TextAlign Gets or sets the alignment of the text label associated with the RadioButton control.
Value Description
Left Text associated with a check box or radio button control appears to the left of the control.
Right Text associated with a check box or radio button control appears to the right of the control.
ValidationGroup Gets or sets the group of controls for which the RadioButton control causes validation when it posts back to the server.

Events and Arguments

Name Description
CheckedChanged Occurs when the value of the Checked property changes between posts to the server.
args As EventArgs

Top

RadioButtonList

 
<asp:RadioButtonList id="id" Runat="Server"
  AutoPostBack="False|True"
  CausesValidation="False|True"
  CellPadding="n"
  CellSpacing="n"
  DataSourceID="id"
  DataTextField="field"
  DataTextFormatString="{string}"
  DataValueField="field"
  RepeatColumns="n"
  RepeatDirection="Horizontal|Vertical"
  RepeatLayout="Flow|Table"
  TextAlign="Left|Right"
  ValidationGroup="name"
  
    property="value"...
    
    OnSelectedIndexChanged="subprogram"
>
	
  <asp:ListItem
    Selected="False|True"
    Text="string"
    Value="value"
  />
  ...
	
</asp:RadioButtonList>

Properties

Name Description
AutoPostBack Gets or sets a value indicating whether a postback to the server automatically occurs when the user changes the list selection.
CausesValidation Gets or sets a value indicating whether validation is performed when a control that is derived from the ListControl class is clicked.
CellPadding Gets or sets the distance (in pixels) between the border and the contents of the table cell.
CellSpacing Gets or sets the distance (in pixels) between adjacent table cells.
DataSourceID Gets or sets the ID of the control from which the data-bound control retrieves its list of data items.
DataTextField Gets or sets the field of the data source that provides the text content of the list items.
DataTextFormatString Gets or sets the formatting string used to control how data bound to the list control is displayed.
DataValueField Gets or sets the field of the data source that provides the value of each list item.
ID Gets or sets the programmatic identifier assigned to the server control.
Items Gets the collection of ListItems in the list control.
Property Description
.Count Gets the number of ListItem objects in the collection.
.(index) Gets a ListItem object at a specified index in the collection.
Property Description
.Selected Gets or sets whether the ListItem is selected.
.Text Gets or sets the text displayed in the ListItem.
.Value Gets or sets the value associated with the ListItem.
Method Description
.Clear() Clear all items from a ListItem collection.
.FindByText("text")
Searches the collection for a ListItem with a Text property that contains the specified value.
.FindByValue("value")
Searches the collection for a ListItem with a Value property that contains the specified value.
.RemoveAt(index) Remove an item from the ListItem at the index location in the collection.
.Add(New ListItem("text","value"))
Add a new ListItem next in order in the collection.
.Insert(index, New ListItem("text","value"))
Add a new ListItem at the index location in the collection.
RepeatColumns Gets or sets the number of columns to display in the RadioButtonList control.
RepeatDirection Gets or sets the direction in which the radio buttons within the group are displayed.
Value Description
Horizontal Items of a list are displayed horizontally in rows from left to right, then top to bottom, until all items are rendered.
Vertical Items of a list are displayed vertically in columns from top to bottom, and then left to right, until all items are rendered.
RepeatLayout Gets or sets the layout of radio buttons within the group.
Value Description
Flow Items are displayed without a table structure.
Table Items are displayed in a table.
SelectedIndex Gets or sets the lowest ordinal index of the selected items in the list.
SelectedItem Gets the selected item with the lowest index in the list control.
SelectedValue Gets the value of the selected item in the list control, or selects the item in the list control that contains the specified value.
Text Gets or sets the SelectedValue property of the ListControl control.
TextAlign Gets or sets the text alignment for the radio buttons within the group.
Value Description
Left Text associated with a check box or radio button control appears to the left of the control.
Right Text associated with a check box or radio button control appears to the right of the control.
ValidationGroup Gets or sets the group of controls for which the control that is derived from the ListControl class causes validation when it posts back to the server.

Methods

Name Description
ClearSelection Clears out the list selection and sets the Selected property of all items to false.

Events and Arguments

Name Description
SelectedIndexChanged Occurs when the selection from the list control changes between posts to the server.
args As EventArgs

Top

Repeater

 
<asp:Repeater id="id" Runat="Server"
  DataSourceID="id">
		
  <HeaderTemplate>
    XHTML and binding expressions
  </HeaderTemplate>
	 
  <ItemTemplate>
    XHTML and binding expressions
  </ItemTemplate>
	  
  <AlternatingItemTemplate>
    XHTML and binding expressions
  </AlternatingItemTemplate>
	
  <SeparatorTemplate>
    XHTML and binding expressions
  </SeparatorTemplate>
			
  <FooterTemplate>
    XHTML and binding expressions
  </FooterTemplate>


</asp:Repeater>

Properties

Name Description
AlternatingItemTemplate Gets or sets how alternating items in the control are displayed.
DataSourceID Gets or sets the ID property of the data source control that the Repeater control should use to retrieve its data source.
FooterTemplate Gets or sets the template for the footer section of the Repeater control.
HeaderTemplate Gets or sets the template for the footer section of the Repeater control.
ID Gets or sets the programmatic identifier assigned to the server control.
Items Gets a collection of RepeaterItem objects representing the individual items within the control.
Property Description
.Count Gets the number of RepeaterItem objects in the collection.
.Item(index) Gets a RepeaterItem object at a specified index in the collection.
Property Description
.ItemIndex Gets the index of the RepeaterItem object.
.ItemType Gets the type (Header, Footer, Item, AlternatingItem, SelectedItem, EditItem, Separator) of the RepeaterItem object.
ItemTemplate Gets or sets the template for the items in the Repeater control.
SeparatorTemplate Gets or sets the template for the separator between the items of the Repeater control.

Events, Arguments, and Properties

Name Description
ItemCommand Occurs when any button is clicked for an item in the Repeater control.
args As RepeaterCommandEventArgs
Name Description
.CommandArgument Gets the argument for the command.
.CommandName Gets the name of the command.
.CommandSource Gets the source of the command.
.Item Gets the RepeaterItem containing the command source.

Top

SiteMapDataSource

 
<asp:SiteMapDataSource id="id" Runat="Server"
  Provider="provider"
  ShowStartingNode="False|True"
  SiteMapProvider="provider"
  StartFromCurrentNode="False|True"
  StartingNodeOffset="n"
  StartingNodeUrl="url"
/>

Properties

Name Description
ID Gets or sets the programmatic identifier assigned to the server control.
Provider Gets or sets a SiteMapProvider object that is associated with the data source control. The instance can be different than the provider that is identified by the SiteMapProvider property, if set.
ShowStartingNode Gets or sets a value indicating whether the starting node is retrieved and displayed.
SiteMapProvider Gets or sets the name of the site map provider that the data source binds to.
StartFromCurrentNode Gets or sets a value indicating whether the site map node tree is retrieved using the node that represents the current page.
StartingNodeOffset Gets or sets a positive or negative integer offset from the starting node that determines the root hierarchy that is exposed by the data source control.
StartingNodeUrl Gets or sets a node in the site map that the data source then uses as a reference point to retrieve nodes from a hierarchical site map.

Top

SiteMapPath

 
<asp:SiteMapPath id="id" Runat="Server"
  ParentLevelsDisplayed="n"
  PathDirection="CurrentToRoot|RootToCurrent"
  PathSeparator="string"
  Provider="provider"
  RenderCurrentNodeAsLink="False|True"
  SiteMapProvider="provider"
    
    CurrentNodeStyle-property="value"...
    NodeStyle-property="value"...
    PathSeparatorStyle-property="value"...
/>

Properties

Name Description
CurrentNodeStyle Gets the style used for the display text for the current node.
ID Gets or sets the programmatic identifier assigned to the server control.
NodeStyle Gets the style used for the display text for all nodes in the site navigation path.
ParentLevelsDisplayed Gets or sets the number of levels of parent nodes the control displays, relative to the currently displayed node.
PathDirection Gets or sets the order that the navigation path nodes are rendered in.
Value Description
CurrentToRoot Nodes are rendered in a hierarchical order from the current node to the top-most node, from left to right.
RootToCurrent Nodes are rendered in a hierarchical order from the top-most node to the current node, from left to right.
PathSeparator Gets or sets the string that delimits SiteMapPath nodes in the rendered navigation path.
PathSeparatorStyle Gets the style used for the PathSeparator string.
Provider Gets or sets a SiteMapProvider that is associated with the Web server control.
RenderCurrentNodeAsLink Indicates whether the site navigation node that represents the currently displayed page is rendered as a hyperlink.
RootNodeStyle Gets the style for the root node display text.
SiteMapProvider Gets or sets the name of the SiteMapProvider used to render the site navigation control.

Top

TemplateField

 
<asp:TemplateField id="id" Runat="Server"
  ConvertEmptyStringToNull="False|True"
  FooterText="string"
  HeaderImageUrl="url"
  HeaderText="string"
  ShowHeader="False|True"
  SortExpression="field"
  
    FooterStyle-property="value"...
    HeaderStyle-property="value"...
    ItemStyle-property="value"...
    property="value"...
>
  
  <HeaderTemplate>
    XHTML and binding expressions
  </HeaderTemplate>
  
  <ItemTemplate>
    XHTML and binding expressions
  </ItemTemplate>
  
  <AlternatingItemTemplate>
    XHTML and binding expressions
  </AlternatingItemTemplate>
  
  <EditItemTemplate>
    XHTML and binding expressions
  </EditItemTemplate>
  
  <InsertItemTemplate>
    XHTML and binding expressions
  </InsertItemTemplate>
  
  <FooterTemplate>
    XHTML and binding expressions
  </FooterTemplate>

</asp:TemplateField>

Properties

Name Description
AlternatingItemTemplate Gets or sets the template for displaying the alternating items in a TemplateField object.
ConvertEmptyStringToNull Gets or sets a value indicating whether the value that the TemplateField object is bound to should be converted to a null reference (Nothing in Visual Basic) if it is Empty.
EditItemTemplate Gets or sets the template for displaying an item in edit mode in a TemplateField object.
FooterStyle Gets or sets the style of the footer of the data control field.
FooterTemplate Gets or sets the template for displaying the footer section of a TemplateField object.
FooterText Gets or sets the text that is displayed in the footer item of a data control field.
HeaderImageUrl Gets or sets the URL of an image that is displayed in the header item of a data control field.
HeaderStyle Gets or sets the style of the header of the data control field.
HeaderTemplate Gets or sets the template for displaying the header section of a TemplateField object.
HeaderText Gets or sets the text that is displayed in the header item of a data control field.
InsertItemTemplate Gets or sets the template for displaying an item in insert mode in a TemplateField object.
InsertVisible Gets a value indicating whether the DataControlField object is visible when its parent data-bound control is in insert mode.
ItemStyle Gets the style of any text-based content displayed by a data control field.
ItemTemplate Gets or sets the template for displaying an item in a data-bound control.
ShowHeader Gets or sets a value indicating whether the header item of a data control field is rendered.
SortExpression Gets or sets a sort expression that is used by a data source control to sort data.

Top

TextBox

 
<asp:TextBox id="id" Runat="Server"
  AutoCompleteType="None"
  AutoPostBack="False|True"
  CausesValidation="False|True"
  Columns="n"
  MaxLength="n"
  ReadOnly="False|True"
  Rows="n"
  Text="string"
  TextMode="SingleLine|MultiLine|Password"
  ValidationGroup="name"
  Wrap="False|True"
    
    property="value"...
    
    OnTextChanged="subprogram"
/>

Properties

Name Description
AutoCompleteType Gets or sets a value that indicates the AutoComplete behavior of the TextBox control.
Value Description
BusinessCity The city for a business address category.
BusinessCountryRegion The country/region for a business address category.
BusinessFax The fax number for a business address category.
BusinessPhone The phone number for a business address category.
BusinessState The state for a business address category.
BusinessStreetAddress The street for a business address category.
BusinessUrl The URL to a business Web site category.
BusinessZipCode The ZIP code for a business address category.
Cellular The phone number for a mobile-phone category.
Company The name of a business category.
Department A department within a business category.
Disabled The AutoComplete feature is disabled for the TextBox control.
DisplayName The name to display for the user category.
Email The user's e-mail address category.
FirstName The first name of the user category.
Gender The gender of the user category.
HomeCity The city for a home address category.
HomeCountryRegion The country/region for a home address category.
HomeFax The fax number for a home address category.
Homepage The URL to a Web site category.
HomePhone The phone number for a home address category.
HomeState The state for a home address category.
HomeStreetAddress The street for a home address category.
HomeZipCode The ZIP code for a home address category.
JobTitle The user's job title category.
LastName The user's last name category.
MiddleName The user's middle name category.
None No category is associated with the TextBox control. All TextBox controls with the same ID share the same value list.
Notes Any supplemental information to include in the form category.
Office The location of the business office category.
Pager The phone number for a pager category.
Search The keyword or keywords with which to search a Web page or Web site category.
AutoPostBack Gets or sets a value indicating whether an automatic post back to the server occurs whenever the user presses the ENTER or the TAB key while in the TextBox control.
CausesValidation Gets or sets a value indicating whether validation is performed when the TextBox control is set to validate when a postback occurs.
Columns Gets or sets the display width of the text box in characters.
ID Gets or sets the programmatic identifier assigned to the server control.
MaxLength Gets or sets the maximum number of characters allowed in the text box.
ReadOnly Gets or sets a value indicating whether the contents of the TextBox control can be changed.
Rows Gets or sets the number of rows displayed in a multiline text box.
Text Gets or sets the text content of the TextBox control.
TextMode Gets or sets the behavior mode (single-line, multiline, or password) of the TextBox control.
Mode Description
SingleLine Produces a single-line text entry box.
MultiLine Produces a multiple-line text entry box.
Password Produces a single-line text entry box with characters echoed as bullets.
ValidationGroup Gets or sets the group of controls for which the TextBox control causes validation when it posts back to the server.
Wrap Gets or sets a value indicating whether the text content wraps within a multiline text box.

Events and Arguments

Name Description
TextChanged Occurs when the content of the text box changes between posts to the server.
args As EventArgs

Top

TreeView

 
<asp:TreeView id="id" Runat="Server"
  AutoGenerateDataBindings="False|True"
  CollapseImageToolTip="string"
  CollapseImageUrl="url"
  DataSourceID="id"
  EnableClientScript="False|True"
  ExpandDepth="n"
  ExpandImageToolTip="string"
  ExpandImageUrl="url"
  ImageSet="Arrows|BulletedList|BulletedList2|BulletedList3|
            BulletedList4|Contacts|Events|Faq|Inbox|News|Simple|
            Simple2|Msdn|WindowsHelp|XPFileExplorer"
  MaxDataBindDepth="n"
  NodeIndent="n"
  NodeWrap="True|False"
  NoExpandImageUrl="url"
  ShowExpandCollapse="False|True"
  ShowLines="False|True"
  Target="_blank|_parent|_search|_self|_top|framename"
  
    HoverNodeStyle-property="value"...
    LeafNodeStyle-property="value"...
    NodeStyle-property="value"...
    ParentNodeStyle-property="value"...
    RootNodeStyle-property="value"...
    SelectedNodeStyle-property="value"...
    property="value"...
>
  
  <Nodes>
		
    <asp:TreeNode
      ImageToolTip="string"
      ImageUrl="url"
      NavigateUrl="url"
      Target="_blank|_parent|_search|_self|_top|framename"
      Text="string"
    />
    ...
    
  </Nodes>

  <DataBindings>

    <asp:TreeNodeBinding
      DataMember="NodeName"
      Depth="n"
      FormatString="{string}"
      ImageToolTip="string"
      ImageToolTipField="field"
      ImageUrl="url"
      ImageUrlField="field"
      NavigateUrl="url"
      NavigateUrlField="field"
      Target="_blank|_parent|_search|_self|_top|framename"
      TargetField="field"
      Text="string"
      TextField="field"
    />
  
  </DataBindings>

</asp:TreeView>

Properties

Name Description
AutoGenerateDataBindings Gets or sets a value indicating whether the TreeView control automatically generates tree node bindings.
CollapseImageToolTip Gets or sets the ToolTip for the image that is displayed for the collapsible node indicator.
CollapseImageUrl Gets or sets the URL to a custom image for the collapsible node indicator.
DataSourceID Gets or sets the ID of the control from which the data-bound control retrieves its list of data items.
EnableClientScript Gets or sets a value indicating whether the TreeView control renders client-side script in compatible browsers to handle expanding and collapsing events.
ExpandDepth Gets or sets the number of levels that are expanded when a TreeView control is displayed for the first time.
ExpandImageToolTip Gets or sets the ToolTip for the image that is displayed for the expandable node indicator.
ExpandImageUrl Gets or sets the URL to a custom image for the expandable node indicator.
HoverNodeStyle Gets a reference to the TreeNodeStyle object that allows you to set the appearance of a node when the mouse pointer is positioned over it.
ID Gets or sets the programmatic identifier assigned to the server control.
ImageSet Gets or sets the group of images to use for the TreeView control.
Value Description
Arrows A predefined image set that uses arrow images.
BulletedList A predefined image set that uses diamond-shaped bullet images.
BulletedList2 A predefined image set that uses square-shaped bullet images.
BulletedList3 A predefined set of sectioned, diamond shaped bullet images.
BulletedList4 A predefined set of alternate sectioned, diamond shaped bullet images in sizes that vary by level.
Contacts A predefined image set that uses MSN Messenger images.
Custom A user-defined image set.
Events A predefined image set that uses event log-styled images.
Faq A predefined image set that uses FAQ-styled images.
Inbox A predefined image set that uses e-mail-styled images.
News A predefined image set that uses newsgroup-styled images.
Simple A predefined image set that uses simple shape outlines.
Simple2 A predefined image set that uses simple filled shapes.
Msdn A predefined image set that uses MSDN images.
WindowsHelp A predefined image set that uses Microsoft Windows Help images.
XPFileExplorer A predefined image set that uses Windows Explorer images available in Microsoft Windows XP.
LeafNodeStyle Gets a reference to the TreeNodeStyle object that allows you to set the appearance of leaf nodes.
LevelStyles Gets a collection of Style objects that represent the node styles at the individual levels of the tree.
MaxDataBindDepth Gets or sets the maximum number of tree levels to bind to the TreeView control.
NodeIndent Gets or sets the indentation amount (in pixels) for the child nodes of the TreeView control.
Nodes Gets a collection of TreeNode objects that represents the root nodes in the TreeView control.
Property Description
.Count Gets the number of TreeNode objects in the collection.
(index) Gets a TreeNode object at a specified index in the collection.
Property Description
.ChildNodes(index) Gets a ChildNode object at a specified index within the TreeNode at a specified index in the collection.
Method Description
.Clear() Removes all items from a Nodes or ChildNodes collection.
.RemoveAt(index) Removes the specified Node or ChildNode object from the collection.
.Add(New TreeNode("text"))
Add a new Node or ChildNode next in order in the collection.
.AddAt(index, New TreeNode("text")
Add a new Node or ChildNode at the index location in the collection.
NodeStyle Gets a reference to the TreeNodeStyle object that allows you to set the default appearance of the nodes in the TreeView control.
NodeWrap Gets or sets a value indicating whether text wraps in a node when the node runs out of space.
NoExpandImageUrl Gets or sets the URL to a custom image for the non-expandable node indicator.
ParentNodeStyle Gets a reference to the TreeNodeStyle object that allows you to set the appearance of parent nodes in the TreeView control.
PathSeparator Gets or sets the character that is used to delimit the node values that are specified by the ValuePath property.
RootNodeStyle Gets a reference to the TreeNodeStyle object that allows you to set the appearance of the root node in the TreeView control.
SelectedNode Gets a TreeNode object that represents the selected node in the TreeView control.
SelectedNodeStyle Gets the TreeNodeStyle object that controls the appearance of the selected node in the TreeView control.
ShowExpandCollapse Gets or sets a value indicating whether expansion node indicators are displayed.
ShowLines Gets or sets a value indicating whether lines connecting child nodes to parent nodes are displayed.
Target Gets or sets the target window or frame in which to display the Web page content that is associated with a node.
Value Description
_blank Renders the content in a new window without frames.
_parent Renders the content in the immediate frameset parent.
_search Renders the content in the search pane.
_self Renders the content in the frame with focus.
_top Renders the content in the full window without frames.
framename Renders the content in the named frame of a frameset.

Top

Wizard

 
<asp:Wizard id="id" Runat="Server"
  ActiveStepIndex="stepindex"
  CancelButtonImageUrl="url"
  CancelButtonText="string"
  CancelButtonType="Button|LinkButton"
  CancelDestinationPageUrl="url"
  CellPadding="n"
  CellSpacing="n"
  DisplayCancelButton="False|True"
  DisplaySideBar="False|True"
  FinishDestinationPageUrl="url"
  FinishCompleteButtonImageUrl="url"
  FinishCompleteButtonText="string"
  FinishCompleteButtonType="Button|LinkButton"
  FinishPreviousButtonImageUrl="url"
  FinishPreviousButtonText="string"
  FinishPreviousButtonType="Button|LinkButton"
  HeaderText="string"
  StepNextButtonImageUrl="url"
  StepNextButtonText="string"
  StepNextButtonType="Button|LinkButton"
  StepPreviousButtonImageUrl="url"
  StepPreviousButtonText="string"
  StepPreviousButtonType="Button|LinkButton"
  StartNextButtonImageUrl="url"
  StartNextButtonText="string"
  StartNextButtonType="Button|LinkButton"
  
    CancelButtonStyle-property="value"
    FinishCompleteButtonStyle-property="value"
    FinishPreviousButtonStyle-property="value"
    NavigationButtonStyle-property="value"
    NavigationStyle-property="value"
    StepNextButtonStyle-property="value"
    StepPreviousButtonStyle-property="value"
    SideBarStyle-property="value"
    StartNextButtonStyle-property="value"
    StepStyle-property="value"
    property="value"...
>
	
  <HeaderTemplate>
    ...controls, XHTML, and text
  </HeaderTemplate>
  
  <StartNavigationTemplate>
    ...controls, XHTML, and text
  </StartNavigationTemplate>
  
  <StepNavigationTemplate>
    ...controls, XHTML, and text
  </StepNavigationTemplate>
  
  <FinishNavigationTemplate>
    ...controls, XHTML, and text
  </FinishNavigationTemplate>
  
  <SideBarTemplate>
    <asp:DataList id="SideBarList" Runat="Server">
      <ItemTemplate>
        <asp:Button id="SideBarButton" Runat="Server"/> or
        <asp:LinkButton id="SideBarButton" Runat="Server"/>
      </ItemTemplate>
    </asp:DataList>
  </SideBarTemplate>
  
  <WizardSteps>
  
    <asp:WizardStep id="id" Runat="Server"
      AllowReturn="False|True"
      StepType="Start|Step|Finish|Complete"
      Title="string"
    >
        ...controls, XHTML, and text
    </asp:WizardStep>
    ...
		
  </WizardSteps>
	
</asp:Wizard>

Properties

Name Description
ActiveStep Gets the step in the WizardSteps collection that is currently displayed to the user.
ActiveStepIndex Gets or sets the index of the current WizardStepBase object.
AllowReturn Gets or sets a value indicating whether the user is allowed to return to the current step from a subsequent step in a WizardStepCollection collection.
CancelButtonImageUrl Gets or sets the URL of the image displayed for the Cancel button.
CancelButtonStyle Gets a reference to a collection of style properties that define the appearance of the Cancel button.
CancelButtonText Gets or sets the text caption that is displayed for the Cancel button.
CancelButtonType Gets or sets the type of button that is rendered as the Cancel button.
Type Description
Button A command button.
Image A button that displays an image.
Link A hyperlink-style button.
CancelDestinationPageUrl Gets or sets the URL that the user is directed to when they click the Cancel button.
CellPadding Gets or sets the amount of space between the contents of the cell and the cell border.
CellSpacing Gets or sets the amount of space between cells.
DisplayCancelButton Gets or sets a Boolean value indicating whether to display a Cancel button.
DisplaySideBar Gets or sets a Boolean value indicating whether to display the sidebar area on the Wizard control.
FinishCompleteButtonImageUrl Gets or sets the URL of the image that is displayed for the Finish button.
FinishCompleteButtonStyle Gets a reference to a Style object that defines the settings for the Finish button.
FinishCompleteButtonText Gets or sets the text caption that is displayed for the Finish button.
FinishCompleteButtonType Gets or sets the type of button that is rendered as the Finish button.
Type Description
Button A command button.
Image A button that displays an image.
Link A hyperlink-style button.
FinishDestinationPageUrl Gets or sets the URL that the user is redirected to when they click the Finish button.
FinishNavigationTemplate Gets or sets the template that is used to display the navigation area on the Finish step.
FinishPreviousButtonImageUrl Gets or sets the URL of the image that is displayed for the Previous button on the Finish step.
FinishPreviousButtonStyle Gets a reference to a Style object that defines the settings for the Previous button on the Finish step.
FinishPreviousButtonText Gets or sets the text caption that is displayed for the Previous button on the Finish step.
FinishPreviousButtonType Gets or sets the type of button that is rendered as the Previous button on the Finish step.
Type Description
Button A command button.
Image A button that displays an image.
Link A hyperlink-style button.
HeaderStyle Gets a reference to a Style object that defines the settings for the header area on the control.
HeaderText Gets or sets the text caption that is displayed for the header area on the control.
ID Gets or sets the programmatic identifier assigned to the server control.
Name Gets the name associated with a step in a control that acts as a wizard.
NavigationButtonStyle Gets a reference to a Style object that defines the settings for the buttons in the navigation area on the control.
NavigationStyle Gets a reference to a Style object that defines the settings for the navigation area on the control.
SideBarButtonStyle Gets a reference to a Style object that defines the settings for the buttons on the sidebar.
SideBarStyle Gets a reference to a Style object that defines the settings for the sidebar area on the control.
SideBarTemplate Gets or sets the template that is used to display the sidebar area on the control.
StartNavigationTemplate Gets or sets the template that is used to display the navigation area on the Start step of the Wizard control.
StartNextButtonImageUrl Gets or sets the URL of the image that is displayed for the Next button on the Start step.
StartNextButtonStyle Gets a reference to a Style object that defines the settings for the Next button on the Start step.
StartNextButtonText Gets or sets the text caption that is displayed for the Next button on the Start step.
StartNextButtonType Gets or sets the type of button that is rendered as the Next button on the Start step.
Type Description
Button A command button.
Image A button that displays an image.
Link A hyperlink-style button.
StepNavigationTemplate Gets or sets the template that is used to display the navigation area on any WizardStepBase-derived objects other than the Start, the Finish, or Complete step.
StepNextButtonImageUrl Gets or sets the URL of the image that is displayed for the Next button.
StepNextButtonStyle Gets a reference to the Style object that defines the settings for the Next button.
StepNextButtonText Gets or sets the text caption that is displayed for the Next button.
StepNextButtonType Gets or sets the type of button that is rendered as the Next button.
Type Description
Button A command button.
Image A button that displays an image.
Link A hyperlink-style button.
StepPreviousButtonImageUrl Gets or sets the URL of the image that is displayed for the Previous button.
StepPreviousButtonStyle Gets a reference to a Style object that defines the settings for the Previous button.
StepPreviousButtonText Gets or sets the text caption that is displayed for the Previous button.
StepPreviousButtonType Gets or sets the type of button that is rendered as the Previous button.
Type Description
Button A command button.
Image A button that displays an image.
Link A hyperlink-style button.
StepStyle Gets a reference to a Style object that defines the settings for the WizardStep objects.
StepType Gets or sets the type of navigation user interface (UI) to display for a step in a Wizard control.
Value Description
Auto The navigation UI that is rendered for the step is determined automatically by the order in which the step is declared.
Complete The step is the last one to appear. No navigation buttons are rendered.
Finish The step is the final data collection step. Finish and Previous buttons are rendered for navigation.
Start The step is the first one to appear. A Next button is rendered but a Previous button is not rendered for this step.
Step The step is any step between the Start and the Finish steps. Previous and Next buttons are rendered for navigation. This step type is useful for overriding the Auto step type.
Title Gets or sets the title to use for a step in a Wizard control when the sidebar feature is enabled.
Wizard Gets the Wizard control that is the parent of the object derived from WizardStepBase.
WizardSteps Gets a collection containing all the WizardStepBase objects that are defined for the control.

Methods

Name Description
GetHistory Returns a collection of WizardStepBase objects that have been accessed.
GetStepType Returns the WizardStepType value for the specified WizardStepBase object.
MoveTo Sets the specified WizardStepBase-derived object as the value for the ActiveStep property of the Wizard control.

Events and Arguments

Name Description
ActiveStepChanged Occurs when the user switches to a new step in the control.
args As EventArgs
CancelButtonClick Occurs when the Cancel button is clicked.
args As EventArgs
FinishButtonClick Occurs when the Finish button is clicked.
args As WizardNavigationEventArgs
NextButtonClick Occurs when the Next button is clicked.
args As WizardNavigationEventArgs
PreviousButtonClick Occurs when the Previous button is clicked.
args As WizardNavigationEventArgs
SideBarButtonClick Occurs when a button in the sidebar area is clicked.
args As WizardNavigationEventArgs

Top

Xml

 
<asp:Xml id="id" Runat="Server"
  DocumentSource="path"
  TransformSource="path"
/>

Properties

Name Description
DocumentSource Gets or sets the path to an XML document to display in the Xml control.
TransformSource Gets or sets the path to an Extensible Stylesheet Language Transformation (XSLT) style sheet that formats the XML document before it is written to the output stream.

Top

XmlDataSource

 
<asp:XmlDataSource id="id" Runat="Server"
  DataFile="file"
  XPath="X-Path expression"
/>

Properties

Name Description
DataFile Specifies the file name of an XML file that the data source binds to.
ID Gets or sets the programmatic identifier assigned to the server control.
XPath Specifies an XPath expression to be applied to the XML data contained by the Data property or by the XML file indicated by the DataFile property.

Methods

Name Description
GetXmlDocument Loads the XML data into memory, either directly from the underlying data storage or from the cache, and returns it in the form of an XmlDataDocument object.
Save Saves the XML data currently held in memory by the XmlDataSource control to disk if the DataFile property is set.

Top

Web Control Properties, Methods, and Events

Properties

Name Description
AccessKey Gets or sets the access key that allows you to quickly navigate to the Web server control.
BackColor Gets or sets the background color of the Web server control.
BorderColor Gets or sets the border color of the Web control.
BorderStyle Gets or sets the border style of the Web server control.
BorderWidth Gets or sets the border width of the Web server control.
CssClass Gets or sets the Cascading Style Sheet (CSS) class rendered by the Web server control on the client.
Enabled Gets or sets a value indicating whether the Web server control is enabled.
EnableTheming Gets or sets a value indicating whether themes apply to this control.
EnableViewState Gets or sets a value indicating whether the server control persists its view state, and the view state of any child controls it contains, to the requesting client.
Font Gets the font properties associated with the Web server control.
Type Description
Bold Gets or sets a value that indicates whether the font is bold.
Italic Gets or sets a value that indicates whether the font is italic.
Name Gets or sets the primary font name.
Names Gets or sets an ordered array of font names.
Overline Gets or sets a value that indicates whether the font is overlined.
Size Gets or sets the font size.
Strikeout Gets or sets a value that indicates whether the font is strikethrough.
Underline Gets or sets a value that indicates whether the font is underlined.
ForeColor Gets or sets the foreground color (typically the color of the text) of the Web server control.
Height Gets or sets the height of the Web server control.
ID Gets or sets the programmatic identifier assigned to the server control.
Page Gets a reference to the Page instance that contains the server control.
Parent Gets a reference to the server control’s parent control in the page control hierarchy.
SkinID Gets or sets the skin to apply to the control.
Style Gets a collection of text attributes that will be rendered as a style attribute on the outer tag of the Web server control.
TabIndex Gets or sets the tab index of the Web server control.
ToolTip Gets or sets the text displayed when the mouse pointer hovers over the Web server control.
Visible Gets or sets a value that indicates whether a server control is rendered as UI on the page.
Width Gets or sets the width of the Web server control.

Methods

Name Description
DataBind Binds a data source to the invoked server control and all its child controls.
FindControl Searches the current naming container for the specified server control.
Focus Sets input focus to a control.
HasControls Determines if the server control contains any child controls.

Events

Name Description
DataBinding Occurs when the server control binds to a data source.
DataBound Occurs after the server control binds to a data source.
Disposed Occurs when a server control is released from memory, which is the last stage of the server control lifecycle when an ASP.NET page is requested.
Init Occurs when the server control is initialized, which is the first step in its lifecycle.
Load Occurs when the server control is loaded into the Page object.
PreRender Occurs after the Control object is loaded but prior to rendering.
Unload Occurs when the server control is unloaded from memory.

Top