SelectionList, contrôle

Article
04/11/2008

Le contrôle SelectionList offre la possibilité d'effectuer une sélection à partir d'une liste dans une interface utilisateur. Bien qu'il s'agisse de listes, un contrôle SelectionList n'a pas les mêmes fonctionnalités ni la même portée qu'un contrôle List. Le choix lié à l'utilisation d'un contrôle SelectionList ou List repose sur les critères suivants :

Envisagez-vous d'inclure un contrôle Command pour l'envoi du formulaire vers le serveur ? Un choix effectué à partir d'un contrôle SelectionList ne génère pas d'événement serveur.
Envisagez-vous de gérer un ou plusieurs éléments sélectionnés ? Un contrôle SelectionList permet de sélectionner plusieurs éléments.
Envisagez-vous d'afficher uniquement une liste réduite ? Envisagez-vous de ne pas prendre en charge les modèles de périphériques, ni la pagination interne ou personnalisée ? Un contrôle SelectionList ne gère que les petites listes et n'offre pas de pagination.
Souhaitez-vous utiliser des listes déroulantes ou des zones de liste déroulantes ? Un contrôle SelectionList prend en charge ces fonctionnalités.

Pour plus d'informations sur le choix entre un contrôle SelectionList et un contrôle List, consultez la classe SelectionList.

Syntaxe des contrôles mobiles

Les propriétés, valeurs par défaut et éléments de code requis sont indiqués en caractères gras.

<mobile:SelectionListrunat="server"
   id="id"
   Font-Name="fontName"
   Font-Size="{NotSet|Normal|Small|Large}"
   Font-Bold="{NotSet|False|True}"
   Font-Italic=""{NotSet|False|True}"
   ForeColor="foregroundColor"
   BackColor="backgroundColor"
   Alignment="{NotSet|Left|Center|Right}"
   StyleReference="styleReference"
   Wrapping="{NotSet|Wrap|NoWrap}"

   DataMember="dataMember"
   DataTextField="DataTextField"
   DataValueField="DataValueField"
   OnItemDataBind="itemDataBindHandler"
   OnSelectedIndexChanged="selectedIndexChangedHandler"
   Rows="rows"
   SelectType="{DropDown|ListBox|Radio|MultiSelectListBox|CheckBox}"
   Title="Text">

Place DeviceSpecific/Choice construct here. (optional)
      <Choice Add choice here>
      </Choice>
   </DeviceSpecific>

      <Choice Add choice here>
      </Choice>
   </DeviceSpecific>

Place statically declared list items here. (optional)
   <Item Text="Text" Value="Value" />
</mobile:SelectionList>

Règles relatives à la relation contenant-contenu

Les contrôles suivants peuvent contenir un contrôle SelectionList.

Contrôle	Commentaires
System.Web.UI.MobileControls.Form	Peut contenir n'importe quel nombre de contrôles SelectionList.
System.Web.UI.MobileControls.Panel	Peut contenir n'importe quel nombre de contrôles SelectionList.

Le contrôle SelectionList peut contenir les contrôles ci-dessous.

Contrôle	Commentaires
System.Web.UI.MobileControls.Item	Un contrôle SelectionList peut contenir n'importe quel nombre de contrôles Item.

Modèles de périphériques

Le contrôle SelectionList ne prend pas en charge les modèles de périphériques.

Comportement spécifique au périphérique

Langage du périphérique	Description du comportement
HTML	Le contrôle SelectionList est rendu sous la forme d'une zone de liste déroulante, d'une zone de liste, d'un groupe de cases d'option ou d'un groupe de cases à cocher, en fonction du contrôle SelectType. La propriété Title est ignorée.
WML	Le contrôle SelectionList est rendu sous la forme d'une construction <select>, ce qui permet à l'utilisateur de se servir des touches du pavé numérique pour cliquer ou sélectionner les éléments. Les autres éléments de l'interface utilisateur de la carte ne sont pas fusionnés dans le bloc select. Le texte de la propriété Title est affiché.

SelectionList, exemple de contrôle

L'exemple suivant montre comment créer une liste de sélection pour les composants d'une chaîne stéréo. Lorsque l'utilisateur choisit un composant, une seconde page affiche le nom et le prix du composant.

<%@ Page Inherits="System.Web.UI.MobileControls.MobilePage"
   Language="VB" %>
<%@ Register TagPrefix="mobile"
    Namespace="System.Web.UI.MobileControls"
    Assembly="System.Web.Mobile" %>

<script language="vb" runat="server">
Public Sub PriceHandler(source As Object, e As EventArgs)
   Dim selectedStereoComponent As String
   selectedStereoComponent = StereoComponents.Selection.Value
   Price.Text = StereoComponents.Selection.Text _
      + " at " + selectedStereoComponent
   ActiveForm = PricePage
End Sub
</script>

<mobile:Form runat="server">
   <mobile:Label>For pricing, select a component:</mobile:Label><br><br>
   <mobile:SelectionList id="StereoComponents" runat="server">
      <item Text="Amplifier" Value="$500.00"/>
      <item Text="Compact Disc" Value="$600.00"/>
      <item Text="Receiver" Value="$1000.00"/>
      <item Text="Speakers" Value="$800.00"/><br>
   </mobile:SelectionList>
   <mobile:Command runat="server" OnClick="PriceHandler">
   Get the price!</mobile:Command>
</mobile:Form>
<mobile:Form runat="server" id="PricePage">
   <mobile:Label runat="server" id="PriceMessage" />
      Stereo Component Price Request</mobile:Label><br>
  <mobile:Label runat="server" id="Price" />
</mobile:Form>
[C#]
<%@ Page Inherits="System.Web.UI.MobileControls.MobilePage"
   Language="c#" %>
<%@ Register TagPrefix="mobile"
    Namespace="System.Web.UI.MobileControls"
    Assembly="System.Web.Mobile" %>

<script language="c#" runat="server">
public void PriceHandler(Object source, EventArgs e)
{
   String selectedStereoComponent = StereoComponents.Selection.Value;
   Price.Text = StereoComponents.Selection.Text
      + " at " + selectedStereoComponent;
   ActiveForm = PricePage;
}
</script>

<mobile:Form runat="server">
   <mobile:Label>For pricing, select a component:</mobile:Label><br><br>
   <mobile:SelectionList id="StereoComponents" runat="server">
      <item Text="Amplifier" Value="$500.00"/>
      <item Text="Compact Disc" Value="$600.00"/>
      <item Text="Receiver" Value="$1000.00"/>
      <item Text="Speakers" Value="$800.00"/><br>
   </mobile:SelectionList>
   <mobile:Command runat="server" OnClick="PriceHandler">
   Get the price!</mobile:Command>
</mobile:Form>
<mobile:Form runat="server" id="PricePage">
   <mobile:Label runat="server" id="PriceMessage" />
      Stereo Component Price Request</mobile:Label><br>
  <mobile:Label runat="server" id="Price" />
</mobile:Form>

Voir aussi

SelectionList, classe | SelectionList, membres de classe | Guide de référence des contrôles

Partager via