ASP.NET Mobile SelectionList Control
 Complete ASP.NET Mobile Reference
Definition and Usage
The SelectionList control is used to create a list on a mobile device.
Differences between a SelectionList control and a List control:
- A SelectionList control supports multiple item selections and the List
control only supports single item selections
- A SelectionList control supports drop-down lists, combo boxes, and radio
buttons and the
List control only supports common lists
- An item selected from a SelectionList control does not generate a server
event
- A SelectionList control does not offer pagination
Properties
| Property |
Value |
Description |
| Alignment |
left
center
right |
Optional. How to align the list |
| BackColor |
rgb(x,x,x)
#xxxxxx
colorname |
Optional. A background color for the list |
| DataMember |
dataMember |
Optional. Specifies the data member to extract in data
binding to a data source |
| DataTextField |
dataTextField |
Optional. |
| DataValueField |
dataValueField |
Optional. |
| ForeColor |
rgb(x,x,x)
#xxxxxx
colorname |
Optional. A foreground color for the list |
| Font-Bold |
false
true |
Optional. Specifies whether or not the text in the list should be bold |
| Font-Italic |
false
true |
Optional. Specifies whether or not the text in the list should be italic |
| Font-Name |
fontname |
Optional. Specifies the font name of the text in the list |
| Font-Size |
normal
small
large |
Optional. Specifies the font size of the text in the list |
| id |
unique_name |
Optional. A unique id for the control |
| OnItemDataBind |
function_name |
Optional. The name of the function to be executed when an
item is data bound to a MobileListItem object |
| OnSelectedIndexChanged |
function_name |
Optional. The name of the function to be executed when the
index of the selected item has changed |
| Rows |
rows |
Optional. Specifies the number of rows to display. Default
is "4" |
| runat |
"server" |
Required. Specifies that the control is a server control |
| SelectType |
DropDown
ListBox
Radio
MultiSelectListBox
CheckBox |
Optional. Specifies the type of list to display. "DropDown"
is default. |
| StyleReference |
name_of_style_element |
Optional. Specifies a reference to a style to be applied to
the control |
| Title |
text |
Optional. Specifies a title to display. Only for WML
devices |
| Wrapping |
wrap
nowrap |
Optional. Specifies whether or not the text in the list should wrap |
Example 1
The following example is an .aspx page with two forms. The first form has a
list of cars. The second form is activated when a car is selected in the first
form, and it displays the price of the selected car:
<%@ Page
Inherits="System.Web.UI.MobileControls.MobilePage"%>
<%@ Register TagPrefix="Mobile"
Namespace="System.Web.UI.MobileControls"
Assembly="System.Web.Mobile" %>
<script runat="server">
Sub Car_Click(sender as Object, e as EventArgs)
ActiveForm=f2
t1.text=cars.Selection.Value
End Sub
</script>
<Mobile:Form id="f1" runat="server">
<Mobile:SelectionList runat="server" id="cars" >
<Item Text="Volvo" Value="$30,000" />
<Item Text="BMW" Value="$32,000" />
<Item Text="Audi" Value="$34,000" />
</Mobile:SelectionList>
<Mobile:Command runat="server"
OnClick="Car_Click" Text="Submit" />
</Mobile:Form>
<Mobile:Form id="f2" runat="server">
<Mobile:Label id="t1" runat="server" />
</Mobile:Form>
|
When this page is displayed on a mobile device, the navigation and
display functions of the page will be compiled differently for different
devices with different display characteristics.
Fore some devices, like a handheld PC, it might display a dropdown list
to choose from. For a cell phone it might display a list of options to
select from.
Complete ASP.NET Mobile Reference
 |
W3Schools' Online Certification Program
The perfect solution for professionals who need to balance work, family, and career building.
More than 4000 certificates already issued!
|
The HTML Certificate documents your knowledge of HTML, XHTML, and CSS.
The JavaScript Certificate documents your knowledge of JavaScript and HTML DOM.
The XML Certificate documents your knowledge of XML, XML DOM and XSLT.
The ASP Certificate documents your knowledge of ASP, SQL, and ADO.
The PHP Certificate documents your knowledge of PHP and SQL (MySQL).
|
