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
 |
 |
 |
 |
|
The Ektron Intranet
lets you do everything you need to do on your corporate intranet and everything you want to do... all with just one application.
What can you do with the Ektron Intranet? |
 |
Navigate through content, documents, assets, colleagues and workgroups quickly and intuitively with enterprise search |
 |
Communicate with friends and colleagues with forums, message boards and corporate blogging using the new Social Networking Platform |
|
Utilize the extensive out-of-the box features or customize your site through Ektron CMS400.NET's open architecture |
 |
Promote collaboration in your organization through project workspaces where others can efficiently find information and work together |
 |
Author/edit content, manage navigation, menus, audit trails, workflow and approvals with the best in breed Content Management |
|
|
|
|
See why there are 20,000+ Ektron integrations worldwide.
|
|
 |
TAKE THE VIDEO TOUR |
 |
or download a FREE TRIAL today. |
|
HOME
Printer friendly page
