Set di adattatori XHTML
Aggiornamento: novembre 2007
Il set di adattatori XHTML esegue il rendering delle pagine Web ASP.NET per dispositivi mobili in client in grado di eseguire il rendering dei linguaggi XHTML Basic e XHTML, ad esempio Microsoft Internet Explorer per Pocket PC.
Nella tabella riportata di seguito vengono elencate le classi del set di adattatori, una proprietà che restituisce una classe e le classi principali incluse nel set di adattatori XHTML.
Classe o proprietà del set di adattatori |
Classe dell'adattatore principale |
|---|---|
Classe base ControlAdapter |
|
Selezione
Il set di adattatori XHTML viene selezionato se il tipo di rendering preferito è "xhtml-basic", "xhtml-mp" o "wml20".
.gif "Nota") Nota: |
|---|
In ASP.NET 2.0 i tipi possibili di rendering preferito per il linguaggio XHTML non fanno parte della classe MobileCapabilities. |
Rendering predefinito
Durante il rendering predefinito delle classi di adattatori di pagine e di form nel set di adattatori XHTML, l'adattatore di pagina effettua i passaggi indicati di seguito.
Chiama i metodi BeginResponse e BeginFile del writer. Il tipo di contenuto è impostato su "text/html".
Scrive una dichiarazione XML (<? xml version=1.0 encoding="encodingType" ?>).
Scrive il riferimento DTD ai documenti XHTML.
Scrive un tag <html xmlns="http://www.w3.org/1999/xhtml" > 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 di apertura, se necessario.
Scrive i tag di apertura <body> e <form>.
Scrive le eventuali variabili nascoste e interne del form, nonché lo script di postback.
Esegue il rendering dei contenuti del form.
Scrive i tag di chiusura </form> e </body>.
Utilizzo degli stili
La classe XhtmlMobileTextWriter rende disponibili i seguenti 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 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à determina quali proprietà di stile vengono scritte. Tali proprietà, ad esempio RenderBold, RenderItalic e così via, vengono impostate al momento della creazione del writer, utilizzando le funzionalità del dispositivo richiedente.
Il parametro breakAfter dei metodi ExitLayout, ExitFormat e ExitStyle controlla se viene inserita un'interruzione dopo i tag di formato e di layout. Se il parametro breakAfter è impostato su true, nell'output viene eseguito il rendering di un'interruzione logica utilizzando un elemento br o div.
Rendering dei controlli di postback
Per impostazione predefinita, i controlli di postback vengono visualizzati come pulsanti. Per utilizzare un collegamento come controllo di postback, è possibile chiamare il metodo RenderPostBackEventAsAnchor della classe base XhtmlControlAdapter. Questo metodo esegue il rendering di un elemento a che esegue il postback del form quando l'utente fa clic sul collegamento.
È inoltre possibile creare un controllo di postback impostando un attributo di altri elementi per un adattatore di controllo. A tale scopo, è possibile chiamare il metodo RenderPostBackEventAsAttribute, Ad esempio, è possibile utilizzare il metodo per creare l'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 controlli di postback.
Per eseguire il rendering di un collegamento per un adattatore di controllo mobile, è possibile chiamare i metodi RenderBeginLink e RenderEndLink della classe base XhtmlControlAdapter. Il metodo RenderBeginLink verifica automaticamente il tipo di collegamento ed esegue il rendering del tag appropriato.
Interfaccia utente secondaria
Il set di adattatori XHTML supporta un'interfaccia utente secondaria utilizzata dai controlli per visualizzare schermate aggiuntive dell'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 XhtmlControlAdapter su una costante nota internamente.
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 XhtmlControlAdapter.