| <mobile:SelectionList runat="server" id="id" Alignment="{NotSet|Left|Center|Right}" BackColor="backgroundColor" BreakAfter="{True|False}" Font-Bold="{NotSet|False|True}" Font-Italic="{NotSet|False|True}" Font-Name="fontName" Font-Size="{NotSet|Normal|Small|Large}" ForeColor="foregroundColor" StyleReference="StyleReference" Wrapping="{NotSet|Wrap|NoWrap}" DataMember="dataMember" DataSource="dataSource" DataTextField="DataTextField" DataValueField="DataValueField" SelectType="{DropDown|ListBox|Radio|MultiSelectListBox|CheckBox}" Title="String" OnItemDataBind="itemDataBindHandler" OnSelectedIndexChanged="selectedIndexChangedHandler"> <!-- 可选,以静态的方式声明数据项--> <Item Text="Text" Value="Value" Selected="{True|False}"/> </mobile:SelectionList> |
| 属性/事件 | 类型 | 描述 |
| DataMember | String | 只有当SelectionList列表控件与一个System.Data.DataTable或System.Data.DataSet对象绑定时才使用此属性。该属性指定用来指定DataSet中那个DataTable是列表控件的真正数据源。 |
| DataSource | Object | 只有当SelectionList列表控件采用数据绑定的方式定义数据项时才使用这个属性。DataSource属性用来指定一个DataSet对象,或是一个集合对象作为列表控件的数据源。 |
| DataTextField | String | 当SelectionList列表控件绑定到DataSet或集合对象时,DataTextField属性用来指定数据源中的某个字段在列表中进行显示。 |
| DataValueField | String | 当SelectionList列表控件绑定到DataSet或集合对象时,DataValueField 属性用来指定数据源中的某个字段,用来提供隐藏值与列表显示的数据项进行关联。 |
| Items | System.Web. UI.MobileControls.Mobil eListItemCollection | 我们可以使用这个属性访问MobileListItemCollection对象,而这个对象又是存储整个列表中的所有数据项对应的System.Web.UI.MobileControls.MobileLi stItem对象。你可以在代码中对这个集合中的各个MobileListItem对象进行操作。 |
| Rows | Integer | 当列表控件的SelectType属性值为ListBox 或MultiSelectListBox时,Rows属性用来设置可以在HTML浏览器和CHTML浏览器中可呈现出的数据项行数。由于WML浏览器不支持多行显示,所有设置该属性是无效的。 |
| SelectedIndex | Integer | 返回或设置当前那个数据项被选中。如果SelectionList列表控件在当前为多选的模式时,也就是说如果你在一个列表中选择可多个数据项,那么SelectedIndex属性返回的是第一个被选中的数据项的索引。 |
| Selection | MobileListItem | 返回被选中的数据项(一个MobileListItem对象),如果在列表中没有选择任何数据项的话,将返回null。 |
| SelectType | System.Web.UI. MobileControls. ListSelectType的枚举值: DropDown| ListBox|Radio| MultiSelectListBox|CheckBox | 该枚举用来反映SelectionList列表控件在设备浏览器上的显示样式。CheckBox 和MultiSelectListBox允许多项选择,其它的枚举值只允许单项选择。该属性的默认值为DropDown. |
| ItemDataBind (event) | 事件处理函数 | 当SelectionList列表控件以数据绑定的形式定义数据项时,在每个数据项被添加到列表中时触发这个事件。 |
| SelectedIndexChanged (event) | 事件处理函数 | 如果SelectionList控件处于单项模式时,当用户使选项方式改变时将调用这个事件处理函数。该事件只有在一个Command控件产生一个从客户端到服务器端的回发时才触发,也就是说该事件是无法由SelectionList控件自动触发的,必须借助于Command控件。 |