共用方式為

XhtmlControlAdapter 類別

  • 參考

定義

命名空間:
System.Web.UI.MobileControls.Adapters.XhtmlAdapters
組件:
System.Web.Mobile.dll

警告

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::ControlAdapter
public 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.ControlAdapter
type 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 ControlAdapter
Public Class XhtmlControlAdapter
Inherits ControlAdapter
繼承
Object
ControlAdapter
XhtmlControlAdapter
衍生
屬性
ObsoleteAttribute

備註

這個類別提供基底行動控件配接器，可在行動裝置的 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
已淘汰.

從包含 CssLocation 屬性的表單中取得其值 (如果屬性存在)。 這個 API 已經過時。 如需如何開發 ASP.NET 行動應用程式的資訊，請參閱 具有 ASP.NET 的Mobile Apps & Sites。
StyleSheetStorageApplicationSetting
已淘汰.

取得 Web.config 檔的 XhtmlCssState 區段中 appSettings 組態設定的值。 這個 API 已經過時。 如需如何開發 ASP.NET 行動應用程式的資訊，請參閱 具有 ASP.NET 的Mobile Apps & Sites。
VisibleWeight
已淘汰.

取得或設定控制項的近似權重 (以字元為單位)。 這個 API 已經過時。 如需如何開發 ASP.NET 行動應用程式的資訊，請參閱 具有 ASP.NET 的Mobile Apps & Sites。

(繼承來源 ControlAdapter)

方法

CalculateOptimumPageWeight(Int32)
已淘汰.

判斷裝置的最佳頁面重量。 這個 API 已經過時。 如需如何開發 ASP.NET 行動應用程式的資訊，請參閱 具有 ASP.NET 的Mobile Apps & Sites。

(繼承來源 ControlAdapter)
ClearPendingBreakIfDeviceBreaksOnBlockLevel(XhtmlMobileTextWriter)
已淘汰.

如果目標裝置會在區塊項目上中斷，則清除暫止中斷。 這個 API 已經過時。 如需如何開發 ASP.NET 行動應用程式的資訊，請參閱 具有 ASP.NET 的Mobile Apps & Sites。
ConditionalClearCachedEndTag(XhtmlMobileTextWriter, String)
已淘汰.

如果符合特定條件，則會清除指定之文字寫入器的目前結束標記。 這個 API 已經過時。 如需如何開發 ASP.NET 行動應用程式的資訊，請參閱 具有 ASP.NET 的Mobile Apps & Sites。
ConditionalClearPendingBreak(XhtmlMobileTextWriter)
已淘汰.

如果符合特定條件，則會清除目標裝置中的暫止中斷。 這個 API 已經過時。 如需如何開發 ASP.NET 行動應用程式的資訊，請參閱 具有 ASP.NET 的Mobile Apps & Sites。
ConditionalEnterFormat(XhtmlMobileTextWriter, Style)
已淘汰.

如果符合特定條件，便會以開頭標記和實作指定樣式之格式的屬性來開始一個區段。 這個 API 已經過時。 如需如何開發 ASP.NET 行動應用程式的資訊，請參閱 具有 ASP.NET 的Mobile Apps & Sites。
ConditionalEnterLayout(XhtmlMobileTextWriter, Style)
已淘汰.

如果符合特定條件，便會以開頭標記和實作指定樣式之配置的屬性來開始一個區段。 這個 API 已經過時。 如需如何開發 ASP.NET 行動應用程式的資訊，請參閱 具有 ASP.NET 的Mobile Apps & Sites。
ConditionalEnterStyle(XhtmlMobileTextWriter, Style)
已淘汰.

如果符合特定條件，將會撰寫 <span> 區段的開頭標記，以及實作指定樣式之配置和字元格式的屬性。 這個 API 已經過時。 如需如何開發 ASP.NET 行動應用程式的資訊，請參閱 具有 ASP.NET 的Mobile Apps & Sites。
ConditionalEnterStyle(XhtmlMobileTextWriter, Style, String)
已淘汰.

如果符合特定條件，將會撰寫指定項目的開頭標記，以及實作指定樣式之配置和字元格式的屬性。 這個 API 已經過時。 如需如何開發 ASP.NET 行動應用程式的資訊，請參閱 具有 ASP.NET 的Mobile Apps & Sites。
ConditionalExitFormat(XhtmlMobileTextWriter, Style)
已淘汰.

如果符合特定條件，則會結束使用指定樣式之字元格式的區塊。 這個 API 已經過時。 如需如何開發 ASP.NET 行動應用程式的資訊，請參閱 具有 ASP.NET 的Mobile Apps & Sites。
ConditionalExitLayout(XhtmlMobileTextWriter, Style)
已淘汰.

如果符合特定條件，則會結束使用指定樣式之配置格式的區塊。 這個 API 已經過時。 如需如何開發 ASP.NET 行動應用程式的資訊，請參閱 具有 ASP.NET 的Mobile Apps & Sites。
ConditionalExitStyle(XhtmlMobileTextWriter, Style)
已淘汰.

如果符合特定條件，則會結束使用指定樣式之配置和字元格式的 </span> 項目。 這個 API 已經過時。 如需如何開發 ASP.NET 行動應用程式的資訊，請參閱 mobile Apps & Sites with ASP.NET。
ConditionalPopPhysicalCssClass(XhtmlMobileTextWriter)
已淘汰.

如果達到特定條件，就從 XhtmlMobileTextWriter 物件移除目前階層式樣式表的類別名稱。 這個 API 已經過時。 如需如何開發 ASP.NET 行動應用程式的資訊，請參閱 mobile Apps & Sites with ASP.NET。
ConditionalRenderClassAttribute(XhtmlMobileTextWriter)
已淘汰.

如果符合特定條件，則會將類別名稱屬性置入要呈現的下一個項目中。 這個 API 已經過時。 如需如何開發 ASP.NET 行動應用程式的資訊，請參閱 mobile Apps & Sites with ASP.NET。
ConditionalRenderClosingDivElement(XhtmlMobileTextWriter)
已淘汰.

如果符合特定條件，將呈現結尾 </div> 標記。 這個 API 已經過時。 如需如何開發 ASP.NET 行動應用程式的資訊，請參閱 mobile Apps & Sites with ASP.NET。
ConditionalRenderClosingSpanElement(XhtmlMobileTextWriter)
已淘汰.

如果符合特定條件，將呈現結尾 </span> 項目。 這個 API 已經過時。 如需如何開發 ASP.NET 行動應用程式的資訊，請參閱 mobile Apps & Sites with ASP.NET。
ConditionalRenderCustomAttribute(XhtmlMobileTextWriter, String)
已淘汰.

如果符合特定條件，會從關聯的控制項取得具有指定名稱的屬性值，並在下一個項目上呈現具有指定名稱的這個值。 這個 API 已經過時。 如需如何開發 ASP.NET 行動應用程式的資訊，請參閱 mobile Apps & Sites with ASP.NET。
ConditionalRenderCustomAttribute(XhtmlMobileTextWriter, String, String)
已淘汰.

如果符合特定條件，會將具有指定名稱和值的自訂屬性併入要呈現的下一個項目中。 這個 API 已經過時。 如需如何開發 ASP.NET 行動應用程式的資訊，請參閱 mobile Apps & Sites with ASP.NET。
ConditionalRenderOpeningDivElement(XhtmlMobileTextWriter)
已淘汰.

如果符合特定條件，則呈現 <div> 項目的開頭標記。 這個 API 已經過時。 如需如何開發 ASP.NET 行動應用程式的資訊，請參閱 mobile Apps & Sites with ASP.NET。
ConditionalRenderOpeningSpanElement(XhtmlMobileTextWriter)
已淘汰.

如果符合特定條件，則呈現 <span> 項目的開頭標記。 這個 API 已經過時。 如需如何開發 ASP.NET 行動應用程式的資訊，請參閱 mobile Apps & Sites with ASP.NET。
ConditionalSetPendingBreak(XhtmlMobileTextWriter)
已淘汰.

如果符合特定條件，將會設定暫止中斷。 這個 API 已經過時。 如需如何開發 ASP.NET 行動應用程式的資訊，請參閱 mobile Apps & Sites with ASP.NET。
ConditionalSetPendingBreakAfterInline(XhtmlMobileTextWriter)
已淘汰.

如果符合特定條件，則會在內嵌項目之後設定暫止中斷。 這個 API 已經過時。 如需如何開發 ASP.NET 行動應用程式的資訊，請參閱 mobile Apps & Sites with ASP.NET。
CreateTemplatedUI(Boolean)
已淘汰.

控制項會呼叫此方法來建立範本化使用者介面 (UI)。 這個 API 已經過時。 如需如何開發 ASP.NET 行動應用程式的資訊，請參閱 具有 ASP.NET 的Mobile Apps & Sites。

(繼承來源 ControlAdapter)
Equals(Object)
已淘汰.

判斷指定的物件是否等於目前的物件。

(繼承來源 Object)
ExitSecondaryUIMode()
已淘汰.

結束控制項的任何第二個 UI 模式。 這個 API 已經過時。 如需如何開發 ASP.NET 行動應用程式的資訊，請參閱 mobile Apps & Sites with ASP.NET。
GetCustomAttributeValue(MobileControl, String)
已淘汰.

從指定的控制項取得指定屬性的值。 這個 API 已經過時。 如需如何開發 ASP.NET 行動應用程式的資訊，請參閱 mobile Apps & Sites with ASP.NET。
GetCustomAttributeValue(String)
已淘汰.

從關聯控制項的標記取得指定屬性的值。 這個 API 已經過時。 如需如何開發 ASP.NET 行動應用程式的資訊，請參閱 mobile Apps & Sites with ASP.NET。
GetDefaultLabel(Int32)
已淘汰.

傳回標籤控制項的當地語系化預設字串。 這個 API 已經過時。 如需如何開發 ASP.NET 行動應用程式的資訊，請參閱 具有 ASP.NET 的Mobile Apps & Sites。

(繼承來源 ControlAdapter)
GetHashCode()
已淘汰.

做為預設雜湊函式。

(繼承來源 Object)
GetType()
已淘汰.

取得目前執行個體的 Type。

(繼承來源 Object)
HandlePostBackEvent(String)
已淘汰.

如果事件已處理，則傳回 true。 這個 API 已經過時。 如需如何開發 ASP.NET 行動應用程式的資訊，請參閱 具有 ASP.NET 的Mobile Apps & Sites。

(繼承來源 ControlAdapter)
LoadAdapterState(Object)
已淘汰.

載入這個配接器特定的檢視狀態資料。 這個 API 已經過時。 如需如何開發 ASP.NET 行動應用程式的資訊，請參閱 mobile Apps & Sites with ASP.NET。
LoadPostData(String, NameValueCollection, Object, Boolean)
已淘汰.

如果由配接器處理張貼資料的載入作業，則傳回 true。 這個 API 已經過時。 如需如何開發 ASP.NET 行動應用程式的資訊，請參閱 具有 ASP.NET 的Mobile Apps & Sites。

(繼承來源 ControlAdapter)
MemberwiseClone()
已淘汰.

建立目前 Object 的淺層複製。

(繼承來源 Object)
OnInit(EventArgs)
已淘汰.

物件 (例如表單或頁面) 初始化之後呼叫。 這個 API 已經過時。 如需如何開發 ASP.NET 行動應用程式的資訊，請參閱 具有 ASP.NET 的Mobile Apps & Sites。

(繼承來源 ControlAdapter)
OnLoad(EventArgs)
已淘汰.

載入與控制項、頁面或裝置配接器有關的資料。 這個 API 已經過時。 如需如何開發 ASP.NET 行動應用程式的資訊，請參閱 具有 ASP.NET 的Mobile Apps & Sites。

(繼承來源 ControlAdapter)
OnPreRender(EventArgs)
已淘汰.

由控制項的 OnPreRender(EventArgs) 方法呼叫，用以在呈現前先執行配置器的專屬工作。 這個 API 已經過時。 如需如何開發 ASP.NET 行動應用程式的資訊，請參閱 具有 ASP.NET 的Mobile Apps & Sites。

(繼承來源 ControlAdapter)
OnUnload(EventArgs)
已淘汰.

卸載控制項、頁面或裝置配接器的相關資料。 這個 API 已經過時。 如需如何開發 ASP.NET 行動應用程式的資訊，請參閱 具有 ASP.NET 的Mobile Apps & Sites。

(繼承來源 ControlAdapter)
PreprocessQueryString(String)
已淘汰.

取得指定查詢字串的部分，其中包含處理要求的參數。 這個 API 已經過時。 如需如何開發 ASP.NET 行動應用程式的資訊，請參閱 mobile Apps & Sites with ASP.NET。
Render(HtmlTextWriter)
已淘汰.

顯示用戶端上相關聯的控制項及其所有子控制項。 這個 API 已經過時。 如需如何開發 ASP.NET 行動應用程式的資訊，請參閱 mobile Apps & Sites with ASP.NET。
Render(XhtmlMobileTextWriter)
已淘汰.

顯示用戶端上相關聯的控制項及其所有子控制項。 這個 API 已經過時。 如需如何開發 ASP.NET 行動應用程式的資訊，請參閱 mobile Apps & Sites with ASP.NET。
RenderAsHiddenInputField(XhtmlMobileTextWriter)
已淘汰.

呈現控制項的隱藏欄位文字。 這個 API 已經過時。 如需如何開發 ASP.NET 行動應用程式的資訊，請參閱 mobile Apps & Sites with ASP.NET。
RenderBeginLink(XhtmlMobileTextWriter, String)
已淘汰.

使用指定的 XhtmlMobileTextWriter 和目標，來呈現連結的開頭標記。 這個 API 已經過時。 如需如何開發 ASP.NET 行動應用程式的資訊，請參閱 mobile Apps & Sites with ASP.NET。
RenderBeginLink(XhtmlMobileTextWriter, String, String, Style, String)
已淘汰.

使用指定的 XhtmlMobileTextWriter 和目標，以及指定的樣式或階層式樣式表類別名稱，呈現連結的開頭標記。 這個 API 已經過時。 如需如何開發 ASP.NET 行動應用程式的資訊，請參閱 mobile Apps & Sites with ASP.NET。
RenderBeginLink(XhtmlMobileTextWriter, String, String, Style, String, String)
已淘汰.

使用指定的 XhtmlMobileTextWriter 和目標，以及指定的樣式或指定的階層式樣式表類別名稱、便捷鍵 (Access Key) 和標題文字，來呈現連結的開頭標記。 這個 API 已經過時。 如需如何開發 ASP.NET 行動應用程式的資訊，請參閱 mobile Apps & Sites with ASP.NET。
RenderChildren(HtmlTextWriter)
已淘汰.

呈現控制項的子系。 這個 API 已經過時。 如需如何開發 ASP.NET 行動應用程式的資訊，請參閱 具有 ASP.NET 的Mobile Apps & Sites。

(繼承來源 ControlAdapter)
RenderClosingListTag(XhtmlMobileTextWriter, String)
已淘汰.

呈現指定清單項目的結尾標記。 這個 API 已經過時。 如需如何開發 ASP.NET 行動應用程式的資訊，請參閱 mobile Apps & Sites with ASP.NET。
RenderEndLink(XhtmlMobileTextWriter)
已淘汰.

呈現連結項目的結尾標記 (</a>)。 這個 API 已經過時。 如需如何開發 ASP.NET 行動應用程式的資訊，請參閱 mobile Apps & Sites with ASP.NET。
RenderOffPageVariables(XhtmlMobileTextWriter, Control, Int32)
已淘汰.

呈現子控制項的隱藏回傳變數，這些變數是因為分頁或第二個 UI 而變成不可見。 這個 API 已經過時。 如需如何開發 ASP.NET 行動應用程式的資訊，請參閱 mobile Apps & Sites with ASP.NET。
RenderOpeningListTag(XhtmlMobileTextWriter, String)
已淘汰.

呈現指定標記名稱的開頭標記。 這個 API 已經過時。 如需如何開發 ASP.NET 行動應用程式的資訊，請參閱 mobile Apps & Sites with ASP.NET。
RenderPostBackEventAsAnchor(XhtmlMobileTextWriter, String, String)
已淘汰.

呈現回傳事件，做為具有指定引數和文字的連結。 這個 API 已經過時。 如需如何開發 ASP.NET 行動應用程式的資訊，請參閱 mobile Apps & Sites with ASP.NET。
RenderPostBackEventAsAnchor(XhtmlMobileTextWriter, String, String, String)
已淘汰.

呈現回傳事件，做為具有指定引數、文字和便捷鍵的連結。 這個 API 已經過時。 如需如何開發 ASP.NET 行動應用程式的資訊，請參閱 mobile Apps & Sites with ASP.NET。
RenderPostBackEventAsAnchor(XhtmlMobileTextWriter, String, String, String, Style, String)
已淘汰.

呈現回傳事件做為連結，並使這個連結具有指定引數、文字、便捷鍵，以及指定的樣式或階層式樣式表類別名稱。 這個 API 已經過時。 如需如何開發 ASP.NET 行動應用程式的資訊，請參閱 mobile Apps & Sites with ASP.NET。
SaveAdapterState()
已淘汰.

儲存這個配接器專用的檢視狀態資料。 這個 API 已經過時。 如需如何開發 ASP.NET 行動應用程式的資訊，請參閱 具有 ASP.NET 的Mobile Apps & Sites。
ToString()
已淘汰.

傳回代表目前物件的字串。

(繼承來源 Object)

適用於

另請參閱