XhtmlControlAdapter 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
警告
The System.Web.Mobile.dll assembly has been deprecated and should no longer be used. For information about how to develop ASP.NET mobile applications, see http://go.microsoft.com/fwlink/?LinkId=157231.
提供預設的控制項配接器，使用 XHTML 標記來呈現行動控制項。 如需如何開發 ASP.NET 行動應用程式的資訊，請參閱 具有 ASP.NET 的Mobile Apps & Sites。
public ref class XhtmlControlAdapter : System::Web::UI::MobileControls::Adapters::ControlAdapterpublic class XhtmlControlAdapter : System.Web.UI.MobileControls.Adapters.ControlAdapter[System.Obsolete("The System.Web.Mobile.dll assembly has been deprecated and should no longer be used. For information about how to develop ASP.NET mobile applications, see http://go.microsoft.com/fwlink/?LinkId=157231.")]
public class XhtmlControlAdapter : System.Web.UI.MobileControls.Adapters.ControlAdaptertype XhtmlControlAdapter = class
inherit ControlAdapter[<System.Obsolete("The System.Web.Mobile.dll assembly has been deprecated and should no longer be used. For information about how to develop ASP.NET mobile applications, see http://go.microsoft.com/fwlink/?LinkId=157231.")>]
type XhtmlControlAdapter = class
inherit ControlAdapterPublic Class XhtmlControlAdapter
Inherits ControlAdapter- 繼承
- 衍生
- 屬性
備註
這個類別提供基底行動控件配接器，可在行動裝置的 XHTML 標記中轉譯控件及其每個子系。 它也提供衍生 XHTML 行動控件配接器的協助程式方法和通用屬性。
控件配接器是覆寫特定類別方法和事件的元件，可允許瀏覽器特定 Control 或標記特定的處理。 轉譯行為的大部分可調整性會封裝在 類別中 XhtmlTextWriter 。 如果您考慮是否要建置自己的控件配接器，請記住，單一配接器可用來覆寫許多瀏覽器類別行為。 或者，藉由在衍生自 類別的 XhtmlMobileTextWriter 類別中包含所需的調整性，您可能會不需要使用控件配接器。
特定控件類別的配接器會套用至繼承自該類別的所有控件，除非存在更特殊的配接器。 例如，類別 XhtmlValidatorAdapter 是用來驗證需要或可以顯示 XHTML 標記之裝置的所有行動控件。
在處理期間，.NET Framework 會攔截目前目標專屬之控件方法的呼叫。 如果控件配接器與控件相關聯，.NET Framework 會呼叫相關聯的配接器方法。
控件的某些屬性會控管其顯示在行動裝置多個次要頁面的方式。 這些頁面統稱為 次要UI。 屬性 SecondaryUIMode 可用來定義要顯示的頁面。 方法 ExitSecondaryUIMode 可用來移除任何次要UI設定。
給繼承者的注意事項
當您繼承自 XhtmlControlAdapter 類別時，請在模式 MarkupControlTypeAdapter 中為指定的控件類型和標記語言命名配接器，例如 XhtmlTextBoxAdapter (，) 。 提供 XHTML 標記之 System.Web.UI.MobileControls.Adapters.XhtmlAdapters 控件的配接器應該在命名空間中實作。
應該針對組態 .browser 檔案中每個裝置節點下的特製化控件定義任何特製化適配卡。
正確實作的控件不應該假設配接器已附加，或附加的配接器會實作特定的介面。 相反地，它應該檢查這些條件。
許多條件式轉譯方法允許次要 UI 之類的條件，以及顯示在每一個區塊之後或每個內嵌控件之後需要換行符的裝置。 這些條件式方法的範例為 ConditionalSetPendingBreak(XhtmlMobileTextWriter) 和 ConditionalEnterLayout(XhtmlMobileTextWriter, Style)。 不論要轉譯的控件為何，這些方法都適用於指定的裝置。 建立以這個類別為基礎的新控件配接器時，您不太可能需要覆寫這些方法。 您至少必須覆寫 Render 方法。
需要裝置篩選，才能使用伺服器控件的特定適配卡。 如需裝置篩選的詳細資訊，請參閱 自適性控制行為架構概觀 和 裝置篩選概觀。
建構函式
| XhtmlControlAdapter() |
已淘汰.
建立 XhtmlControlAdapter 類別的新執行個體。 這個 API 已經過時。 如需如何開發 ASP.NET 行動應用程式的資訊，請參閱 具有 ASP.NET 的Mobile Apps & Sites。 |
欄位
| NotSecondaryUI |
已淘汰.
SecondaryUIMode 屬性傳回的值，表示配置器目前不在第二個 UI 模式中。 這個 API 已經過時。 如需如何開發 ASP.NET 行動應用程式的資訊，請參閱 mobile Apps & Sites with ASP.NET。 |
屬性
| Control |
已淘汰.
傳回關聯控制項的強型別參考。 這個 API 已經過時。 如需如何開發 ASP.NET 行動應用程式的資訊，請參閱 具有 ASP.NET 的Mobile Apps & Sites。 (繼承來源 ControlAdapter) |
| CssLocation |
已淘汰.
指出樣式表是位於外部實體檔案中、位於目前頁面內部、儲存於目前的工作階段狀態中，還是儲存於應用程式快取中。 這個 API 已經過時。 如需如何開發 ASP.NET 行動應用程式的資訊，請參閱 mobile Apps & Sites with ASP.NET。 |
| Device |
已淘汰.
傳回與要求關聯的裝置功能物件。 這個 API 已經過時。 如需如何開發 ASP.NET 行動應用程式的資訊，請參閱 具有 ASP.NET 的Mobile Apps & Sites。 (繼承來源 ControlAdapter) |
| DocumentType |
已淘汰.
表示用來呈現目前文件的 XHTML 標記類型。 這個 API 已經過時。 如需如何開發 ASP.NET 行動應用程式的資訊，請參閱 mobile Apps & Sites with ASP.NET。 |
| ItemWeight |
已淘汰.
存取控制項中單一項目的近似權重。 這個 API 已經過時。 如需如何開發 ASP.NET 行動應用程式的資訊，請參閱 具有 ASP.NET 的Mobile Apps & Sites。 (繼承來源 ControlAdapter) |
| Page |
已淘汰.
傳回裝置配置器所關聯的頁面。 這個 API 已經過時。 如需如何開發 ASP.NET 行動應用程式的資訊，請參閱 具有 ASP.NET 的Mobile Apps & Sites。 (繼承來源 ControlAdapter) |
| PageAdapter |
已淘汰.
取得關聯控制項所在頁面的頁面配置器。 這個 API 已經過時。 如需如何開發 ASP.NET 行動應用程式的資訊，請參閱 mobile Apps & Sites with ASP.NET。 |
| SecondaryUIMode |
已淘汰.
取得目前的第二個 UI 模式。 這個 API 已經過時。 如需如何開發 ASP.NET 行動應用程式的資訊，請參閱 具有 ASP.NET 的Mobile Apps & Sites。 |
| Style |
已淘汰.
傳回與附加裝置配接器的控制項相關聯的樣式物件。 這個 API 已經過時。 如需如何開發 ASP.NET 行動應用程式的資訊，請參閱 具有 ASP.NET 的Mobile Apps & Sites。 (繼承來源 ControlAdapter) |
| StyleSheetLocationAttributeValue |
已淘汰.
從包含 |
| StyleSheetStorageApplicationSetting |
已淘汰.
取得 Web.config 檔的 |
| VisibleWeight |
已淘汰.
取得或設定控制項的近似權重 (以字元為單位)。 這個 API 已經過時。 如需如何開發 ASP.NET 行動應用程式的資訊，請參閱 具有 ASP.NET 的Mobile Apps & Sites。 (繼承來源 ControlAdapter) |
