Controllo Form

  • Articolo

Oltre a caratterizzarsi come contenitore di un numero indefinito di controlli, il controllo Form rappresenta anche il raggruppamento di controlli più esterno all'interno di un oggetto MobilePage. Poiché in un form sono in genere contenuti più controlli, è possibile considerare questo controllo come un insieme di controlli separatamente indirizzabile che è possibile individuare dall'interno dell'applicazione.

Quando su un form singolo sono presenti più controlli, questi vengono separati in più unità per il dispositivo di destinazione appropriato. Tuttavia, poiché un form è considerato un'unità separata di discorso, ovvero un insieme di controlli separatamente indirizzabile, su una singola schermata non saranno mai combinati più form.

Sintassi dei controlli mobili

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

<mobile:Formrunat="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}"

   Action="url"
   Method="{Post|Get}"
   OnActivate="activateHandler"
   OnDeactivate="deactivateHandler"
   OnPaginate=changeHandler"
   Paginate="{True|False}"
   Title="formTitle">
Place child controls here. (optional)
</mobile:Form>

Regole di contenimento

I controlli descritti di seguito possono contenere un controllo Form.

Controllo Commenti
System.Web.UI.MobileControls.MobilePage Deve contenere uno o più controlli Form.

In un controllo Form possono essere contenuti i controlli descritti di seguito.

Controllo Commenti
Tutti i membri di System.Web.UI.MobileControls, ad eccezione degli oggetti MobilePage, Form e StyleSheet. Nei form può essere contenuto qualsiasi controllo mobile ASP.NET, ad eccezione di altri form o fogli di stile.

È necessario che nei form siano contenuti uno o più controlli descritti nella colonna Control.

Modelli di dispositivo

Per ulteriori informazioni su come specificare i modelli riportati di seguito, vedere l'elemento <DeviceSpecific> o l'elemento <Choice>.

Modello Descrizione
Header Il rendering del modello dell'intestazione viene eseguito all'inizio del form. In modalità di impaginazione il rendering dell'intestazione viene eseguito su ogni pagina.
Footer Il rendering del modello del piè di pagina viene eseguito alla fine del form. In modalità di impaginazione il rendering del piè di pagina viene eseguito su ogni pagina.
Script Il rendering del modello dello script viene eseguito nella parte superiore del form. Se il form viene impaginato su più schermate, in ogni schermata sarà incluso il modello dello script. Il codice incluso nel modello dello script viene aggiunto subito dopo il tag di apertura <head> nei dispositivi basate su HTML e subito dopo il tag di apertura <card> nei dispositivi basate su WML.

I modelli dell'intestazione e del piè di pagina possono essere inclusi in un insieme di modelli indipendenti dal dispositivo. Se l'insieme di modelli è indipendente dal dispositivo, sarà necessario che nei modelli siano presenti controlli mobili.

Comportamento specifico del dispositivo

Se le proprietà di stile sono impostate per un controllo Form che eredita dai controlli singoli, qualsiasi comportamento specifico del dispositivo applicabile ai controlli singoli sarà applicato alle proprietà di stile.

Per i dispositivi che supportano l'utilizzo di TAB tra i controlli, l'ordine di tabulazione viene definito in base all'ordine in cui i controlli vengono visualizzati sulla pagina oppure, quando vengono aggiunti in modo dinamico, in base all'ordine in cui sono aggiunti alla pagina.

Linguaggio del dispositivo Descrizione del comportamento
HTML Se un form presenta una proprietà Title definita, il titolo verrà scritto nel tag <title> della sezione <head> del documento.

Se viene eseguito il rendering dei modelli, questi verranno scritti nell'ordine nel tag <body>.

Nel codice riportato di seguito viene descritta la struttura di base di una pagina HTML.

<head>
  <title>title</title>
</head>
<body>
Add header template here.
  Add form contents here.
Add footer template contents here.
</body>

È possibile utilizzare il codice precedente per un form che si adatta completamente a una pagina singola o per un form di cui non è in corso l'impaginazione.
WML Se un form presenta una proprietà Title definita, il titolo verrà scritto come attributo Title di un tag <card> del form. In rari casi questa operazione può determinare risultati imprevisti su alcuni dispositivi, quindi il titolo non verrà scritto in un tag <card>.

Se viene eseguito il rendering dei modelli, questi verranno scritti nell'ordine nel tag <p> all'interno di una card WML.

Nel codice riportato di seguito viene descritta la struttura di base di una pagina WML.

<card title="title">
<p>
header templatecontent template or form contentsfooter template
</p>
</card>

Esempio

Nell'esempio riportato di seguito viene creato un form con due etichette.

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

<mobile:Form runat="server">
  <mobile:Label runat="server">Aardvark</mobile:Label>
  <mobile:Label runat="server">Bear</mobile:Label>
</mobile:Form>

Vedere anche

Classe Form | Membri della classe Form | Riferimenti ai controlli