Set di adattatori HTML
Aggiornamento: novembre 2007
Il set di adattatori HTML esegue il rendering delle pagine Web ASP.NET per dispositivi mobili 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 sono elencate le classi di base incluse nel set di adattatori HTML.
Set di adattatori |
Spazio dei nomi delle classi di adattatori principali |
|---|---|
Classe base astratta ControlAdapter |
|
Classe HtmlControlAdapter |
|
Classe astratta PageAdapter |
|
Classe MobileTextWriter |
Selezione
Il set di adattatori HTML viene selezionato se la proprietà PreferredRenderingType della classe MobileCapabilities restituisce PreferredRenderingTypeHtml32 e la proprietà JavaScript della classe delle funzionalità del browser restituisce true.
Rendering predefinito
Di seguito viene descritto il rendering predefinito delle classi di adattatori di pagine e di form nel set di adattatori HTML.
L'adattatore di pagina utilizza la seguente procedura:
Chiama i metodi BeginResponse e BeginFile nel writer. Il tipo di contenuto è text/html.
Scrive un tag <html> di apertura.
Esegue il rendering del form attivo.
Scrive un tag </html> di chiusura.
Chiama i metodi EndFile e EndResponse.
L'adattatore di form utilizza la seguente procedura:
Scrive un elemento <title>, se necessario.
Scrive i tag <body> e <form>.
Scrive le variabili nascoste e interne del form, nonché lo script di postback.
Esegue il rendering dei contenuti del form.
Scrive i tag </form> e </body> di chiusura.
Utilizzo degli stili
La classe HtmlMobileTextWriter rende disponibili numerosi metodi di supporto per l'utilizzo delle informazioni di stile al fine di controllare l'aspetto dei caratteri e del layout:
I metodi EnterFormat e ExitFormat delimitano un blocco di formattazione dei caratteri.
I metodi EnterLayout e ExitLayout delimitano un blocco di layout di allineamento e ritorno a capo.
I metodi EnterStyle e 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. Queste proprietà, ad esempio RenderBold, RenderItalic e così via, vengono impostate quando si crea il writer utilizzando le funzionalità del dispositivo richiedente.
Il parametro breakAfter dei metodi ExitLayout(Style, Boolean), ExitFormat(Style, Boolean) e ExitStyle(Style, Boolean) controlla se viene inserita un'interruzione dopo i tag di formato e di layout. Se questo parametro è impostato su true, nell'output viene visualizzata un'interruzione logica utilizzando un elemento <br> o <div>.
Rendering dei postback
Il rendering dei postback di form viene eseguito sotto forma di chiamate allo script client scritto 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, questo metodo scrive un tag <a> e genera un postback.
Per eseguire il rendering di un evento di postback come attributo di un altro tag di un adattatore di controllo, è possibile chiamare il metodo RenderPostBackEventAsAttribute. Questo metodo può essere utilizzato nell'ambito di altri tag, ad esempio per creare 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 controllo mobile, è 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 un'interfaccia utente secondaria, un adattatore di controllo effettua la seguente procedura:
In risposta all'interazione di un utente, in genere nel metodo HandlePostBackEvent di cui è possibile eseguire l'override, l'adattatore di controllo specifica la modalità di interfaccia utente secondaria impostando la proprietà SecondaryUIMode della classe base HtmlControlAdapter.
Durante il rendering, il controllo verifica se è attiva la modalità di interfaccia utente secondaria ed esegue il rendering dell'interfaccia utente secondaria appropriata.
In risposta all'interazione dell'utente dall'interfaccia utente secondaria, l'adattatore di controllo potrebbe cambiare la modalità di interfaccia utente secondaria impostandola su un altro valore oppure potrebbe uscire da tale modalità chiamando il metodo ExitSecondaryUIMode della classe base HtmlControlAdapter.