Set di adattatori HTML
Il set di adattatori HTML esegue il rendering delle pagine Web Forms mobili di ASP .NET in client in grado di eseguire il rendering di HTML 3.2 con script attivati, ad esempio Microsoft Internet Explorer per Pocket PC.
Nella tabella riportata di seguito vengono elencate le classi fondamentali incluse nel set di adattatori HTML.
| Set di adattatori | Spazio dei nomi della classe fondamentale di adattatori |
|---|---|
| Classe base ControlAdapter | System.Web.UI.MobileControls.Adapters.HtmlControlAdapter |
| Classe FormAdapter | System.Web.UI.MobileControls.Adapters.HtmlFormAdapter |
| Classe PageAdapter | System.Web.UI.MobileControls.Adapters.HtmlControlAdapter |
| Classe TextWriter | System.Web.UI.MobileControls.Adapters.HtmlMobileTextWriter |
Selezione
Il set di adattatori HTML viene selezionato se la proprietà PreferredRenderingType della classe MobileCapabilities restituisce html32 e se la proprietà JavaScript della classe delle funzionalità del browser restituisce true.
Rendering predefinito
Di seguito vengono riportati i rendering predefiniti delle classi di adattatori di pagine e di form nel set di adattatori HTML.
L'adattatore di pagina esegue le operazioni seguenti:
- Chiama i metodi BeginResponse e BeginFile nel writer. Il tipo di contenuto è text/html.
- Scrive un tag di apertura <html>.
- Esegue il rendering del form attivo.
- Scrive un tag </html> di chiusura.
- Chiama i metodi EndFile ed EndResponse.
L'adattatore di form esegue le operazioni seguenti:
- Scrive un tag <title> di apertura, se necessario.
- Scrive i tag <body> e <form>.
- Scrive le variabili nascoste e interne del form nonché lo script di postback.
- Esegue il rendering del contenuto del form.
- Scrive i tag </form> e </body> di chiusura.
Utilizzo degli stili
La classe HtmlMobileTextWriter rende disponibile una serie di metodi di supporto per l'utilizzo delle informazioni di stile al fine di controllare alcuni aspetti della visualizzazione dei caratteri o del layout:
- I metodi EnterFormat ed ExitFormat delimitano un blocco di formattazione dei caratteri.
- I metodi EnterLayout ed ExitLayout delimitano un blocco di layout di allineamento e ritorno a capo.
- I metodi EnterStyle ed ExitStyle delimitano un blocco di formattazione dei caratteri e del layout di allineamento e ritorno a capo.
Un serie di proprietà controlla quali proprietà di stile vengono scritte. Tali proprietà (quali RenderBold, RenderItalic e così via) vengono impostate quando si crea il writer utilizzando le funzionalità del dispositivo richiedente.
Il parametro breakAfter dei metodi ExitLayout, ExitFormat ed ExitStyle controlla se viene inserita un'interruzione dopo i tag di formattazione e di layout. Se il parametro è impostato su true, viene visualizzata un'interruzione logica nell'output mediante l'utilizzo di un tag <br> o <div>.
Rendering dei postback
Il rendering dei postback di form viene eseguito sotto forma di chiamate a una parte di script scritta con il form.
Per eseguire il rendering di un evento di postback come ancoraggio di un adattatore, è possibile chiamare il metodo RenderPostBackEventAsAnchor della classe base HtmlControlAdapter. Se l'utente fa clic sul collegamento, tale metodo scrive un tag <a> e genera un postback.
Per eseguire il rendering di un evento di postback come un attributo di un altro tag per un adattatore di controllo, è possibile chiamare il metodo RenderPostBackEventAsAttribute. Questo metodo può essere utilizzato nell'ambito di altri tag; ad esempio, è possibile scrivere un attributo onClick per un pulsante.
Rendering dei collegamenti
Il rendering dei collegamenti ad altre pagine viene eseguito sotto forma di collegamenti ipertestuali. Il rendering dei collegamenti ad altri form nella stessa pagina viene invece eseguito sotto forma di postback di form.
Per eseguire il rendering di un collegamento per un adattatore di controlli mobili, è possibile chiamare i metodi RenderBeginLink e RenderEndLink della classe base HtmlControlAdapter. Il metodo RenderBeginLink verifica automaticamente il tipo di collegamento ed esegue il rendering del tag appropriato.
Interfaccia utente secondaria
Il set di adattatori HTML supporta l'interfaccia utente secondaria. Tale interfaccia viene utilizzata dai controlli che visualizzano schermate aggiuntive di un'interfaccia utente. Per utilizzare l'interfaccia utente secondaria, l'adattatore di un controllo esegue le operazioni seguenti:
- In risposta all'interazione dell'utente (generalmente nel metodo HandlePostBackEvent, di cui è possibile eseguire l'override), l'adattatore del controllo imposta la modalità dell'interfaccia utente secondaria su una costante nota internamente, mediante l'utilizzo della proprietà SecondaryUIMode della classe base HtmlControlAdapter.
- Durante il rendering, il controllo verifica se è attivata la modalità dell'interfaccia utente secondaria e utilizza tale modalità per eseguire il rendering dell'interfaccia utente secondaria appropriata.
- In risposta all'interazione dell'utente dall'interfaccia utente secondaria, l'adattatore del controllo può modificare la modalità dell'interfaccia secondaria o uscire da essa chiamando il metodo ExitSecondaryUIMode della classe base HtmlControlAdapter.