SelectionList コントロールは、項目の一覧を表示し、ユーザーに 1 つまたは複数の項目を一覧から選択できるようにします。SelectionList コントロールは、ドロップダウン リスト ボックス、単一選択一覧ボックス、チェック ボックスのセット、またはオプション ボタン (オプション ボタン) のセットとしてレンダリングできます。SelectionList コントロールは、Form コントロールまたは Panel コントロール内、あるいはコントロールのテンプレート内に配置する必要があります。

このコントロールは改ページ調整をサポートしていないので、短い一覧を表示する場合に最も有効です。データベースからの多岐にわたる情報を表形式で表示するには、ObjectList コントロールを使用します。

SelectionList コントロールにある項目を選択しても、アプリケーションのサーバー側からの応答は生成されません。SelectionList がレンダリングされるフォームは、サーバーにポストバックされる必要があります。このポストバックは、通常、Command コントロールを使用して行います。Command コントロールがフォームをサーバーにポストバックすると、SelectionList コントロールが SelectedIndexChanged イベントを生成します。アプリケーションは、このイベントを処理するメソッドを提供できます。もう 1 つの方法は、クライアントサイド JavaScript (例、HTML ブラウザ) を処理できるデバイスのサポートを追加することです。詳細については、「SelectionList コントロール」を参照してください。

既定では、アプリケーションはドロップダウン リストとして SelectionList コントロールをレンダリングします。この既定値を変更するには、[プロパティ] ウィンドウの SelectType プロパティを使用します。SelectType プロパティに DropDown を設定すると、ユーザーは一覧から項目を 1 つだけ選択可能になることに注意してください。2 つ以上の項目を選択可能にするには、SelectType プロパティに CheckBox または MultiSelectListBox を設定します。

デザイン時に一覧の項目を定義するには、ASP.NET モバイル デザイナの [プロパティ] ウィンドウの Items プロパティの横にある省略記号 () をクリックします。デザイナの [SelectionList プロパティ] ダイアログ ボックスが表示されます。このダイアログ ボックスを使用して、一覧に項目を追加します。

また、アプリケーションは、実行時に項目を SelectionList に定義できます。この定義は、プログラムから、またはデータ連結の使用を使用して行えます。Items プロパティの型は、MobileListItemCollection 型です。したがって、アプリケーションがプログラムで項目を追加するには、MobileListItemCollection クラスの Add メソッドを使用します。データ連結をとおして項目を追加するには、SelectionList コントロールの DataBindings、DataMember、DataSource、DataTextField、および DataValueField プロパティを使用します。

アプリケーションは、デバイス フィルタを使用して SelectionList コントロールの外観をカスタマイズできます。デバイス フィルタを使用すると、SelectionList コントロールの多くのプロパティの値を個別にオーバーライドできます。

このコントロールへのユーザー入力を検証する方法については、「検証コントロールの概要」を参照してください。

参照

SelectionList コントロールの追加と構成 | SelectionList コントロール | SelectionList クラス | プロパティのオーバーライド | Form コントロールの概要 | Panel コントロールの概要 | ObjectList コントロールの概要 | データ連結の使用