Controllo SelectionList

  • Articolo

Il controllo SelectionList fornisce fondamentalmente funzionalità di selezione dell'interfaccia utente per un elenco. Sebbene siano entrambi elenchi, un controllo SelectionList differisce nelle funzionalità e nell'ambito da un controllo List. L'utilizzo di un controllo SelectionList piuttosto che di un controllo List dipende dai seguenti criteri:

  • Includere un controllo Command per l'invio di un form al server. Una selezione eseguita da un controllo SelectionList non genera un evento server.
  • Gestione di uno o più elementi selezionati. Un controllo SelectionList consente la selezione di più elementi.
  • Esecuzione del rendering soltanto di un elenco di piccole dimensione. Nessun supporto dei modelli di dispositivo oppure dell'impaginazione personalizzata o interna. Un controllo SelectionList gestisce soltanto elenchi di piccole dimensioni e non consente l'impaginazione.
  • Utilizzo degli elenchi a discesa o delle caselle combinate. Un controllo SelectionList supporta le funzionalità descritte.

Per informazioni dettagliate sull'utilizzo di un controllo SelectionList piuttosto che di un controllo List, vedere la classe SelectionList.

Sintassi dei controlli mobili

Le proprietà necessarie, le impostazioni predefinite e gli elementi dalle funzionalità di codice sono in grassetto.

<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>

Regole di contenimento

I controlli descritti di seguito possono contenere un controllo SelectionList.

Controllo Commenti
System.Web.UI.MobileControls.Form Può contenere un numero indefinito di controlli SelectionList.
System.Web.UI.MobileControls.Panel Può contenere un numero indefinito di controlli SelectionList.

Nel controllo SelectionList possono essere contenuti i controlli descritti di seguito.

Controllo Commenti
System.Web.UI.MobileControls.Item In un controllo SelectionList può essere contenuto un numero indefinito di controlli Item.

Modelli di dispositivo

Il controllo SelectionList non supporta modelli di dispositivo.

Comportamento specifico del dispositivo

Linguaggio del dispositivo Descrizione del comportamento
HTML A seconda del controllo SelectType il controllo SelectionList viene rappresentato come una casella combinata, una casella di riepilogo, un gruppo di pulsanti di opzione o un gruppo di caselle di controllo.

La proprietà Title viene ignorata.
WML Il controllo SelectionList viene rappresentato come un costrutto <select> consentendo all'utente di utilizzare tasti numerici per fare clic o selezionare elementi. Gli altri elementi di interfaccia utente sulla card non vengono uniti nel blocco di selezione.

Viene visualizzato il testo nella proprietà Title.

Esempio del controllo SelectionList

Nell'esempio riportato di seguito viene illustrato come creare un elenco di selezione per componenti stereo. Quando l'utente seleziona un componente, verrà visualizzata una seconda pagina in cui sono descritti il prezzo e il nome del componente.

<%@ 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>

Vedere anche

Classe SelectionList | Membri della classe SelectionList | Riferimenti ai controlli