XHTML 配接器集
更新：2007 年 11 月
XHTML 配接器集會在能夠呈現 XHTML Basic 和 XHTML 的用戶端上 (例如適用於 Pocket PC 的 Microsoft Internet Explorer) 呈現 ASP.NET Mobile Web 網頁。
下表列出配接器集類別、傳回類別的屬性，以及隨 XHTML 配接器集提供的核心類別。
配接器集類別或屬性 |
核心配接器類別 |
|---|---|
ControlAdapter (基底類別) |
|
選取範圍
如果慣用呈現類型為 "xhtml-basic"、"xhtml-mp" 或 "wml20"，便會選取 XHTML 配接器集。
.gif "注意事項") 注意事項： |
|---|
在 ASP.NET 2.0 中，XHTML 的可能慣用呈現類型並不是 MobileCapabilities 類別的一部分。 |
預設呈現
在預設呈現 XHTML 配接器集中的頁面和表單配接器類別期間，頁面配接器會執行下列步驟。
呼叫寫入器的 BeginResponse 和 BeginFile 方法。內容類型會設為 "text/html"。
寫入 XML 宣告 (<? xml version=1.0 encoding="encodingType" ?>)。
寫入 XHTML 文件 DTD 參考。
寫入開頭 <html xmlns="http://www.w3.org/1999/xhtml" > 標記。
呈現作用中表單。
寫入結尾 </html> 標記。
呼叫 EndFile 和 EndResponse 方法。
表單配置器會執行下列步驟：
如果需要一個開頭 title 項目，便會寫出該項目。
寫入開頭 <body> 和 <form> 標記。
寫入任何隱藏和內部表單變數，以及寫入回傳指令碼。
呈現表單內容。
寫入結尾 </form> 和 </body> 標記。
使用樣式
XhtmlMobileTextWriter 類別提供下列 Helper 方法，以協助使用樣式資訊來控制字元或配置外觀等內容。
EnterFormat 和 ExitFormat 方法會分隔字元格式區塊。
EnterLayout 和 ExitLayout 方法會分隔對齊和換行配置區塊。
EnterStyle 和 ExitStyle 方法會分隔字元格式區塊及對齊和換行配置區塊。
數個屬性決定要寫入的樣式屬性。當使用要求之裝置的裝置功能建立寫入器時，便會設定這些屬性 (例如 RenderBold、RenderItalic 等)。
ExitLayout、ExitFormat 和 ExitStyle 等方法的 breakAfter 參數，可以控制是否要在格式和配置標記後插入中斷。如果 breakAfter 參數設為 true，輸出中便會呈現使用 br 或 div 項目的邏輯中斷。
呈現回傳控制項
根據預設，表單回傳控制項會呈現為按鈕。若要使用連結做為回傳控制項，您可以呼叫 XhtmlControlAdapter 基底類別的 RenderPostBackEventAsAnchor 方法。這個方法會呈現一個 a 項目，此項目會在使用者按一下連結時回傳表單。
您也可以針對控制項配接器設定其他項目的屬性，以建立一個回傳控制項。若要這樣做，您可以呼叫 RenderPostBackEventAsAttribute 方法。例如，您可使用方法建立按鈕的 onClick 屬性。
呈現連結
指向其他頁面的連結會呈現為超連結 (Hyperlink)。指向相同頁面上之其他表單的連結會呈現為回傳控制項。
若要呈現行動控制項配接器的連結，您可以呼叫 XhtmlControlAdapter 基底類別的 RenderBeginLink 和 RenderEndLink 方法。RenderBeginLink 方法會自動檢查連結類型，並且呈現適當的標記。
輔助 UI
XHTML 配接器集支援可由控制項用來顯示使用者介面之額外畫面的「輔助 UI」(Secondary UI)。若要使用輔助 UI，控制項配接器會執行下列步驟：
為了回應某些使用者互動 (通常位於可覆寫的 HandlePostBackEvent 方法中)，控制項配接器會將 XhtmlControlAdapter 基底類別的 SecondaryUIMode 屬性設定成內部已知的常數，以指定輔助 UI 模式。
在呈現過程中，控制項會檢查其是否處於輔助 UI 模式；如果是，便會呈現適當的輔助 UI。
為了回應來自輔助 UI 的使用者互動，控制項配接器可能會將輔助 UI 模式變更為其他的值，或是呼叫 XhtmlControlAdapter 基底類別的 ExitSecondaryUIMode 方法，以結束輔助 UI 模式。