WebControlAdapter Třída

Definice

Obor názvů:

System.Web.UI.WebControls.Adapters

Sestavení:

System.Web.dll

Přizpůsobí vykreslování webového ovládacího prvku, ke kterému je adaptér ovládacího prvku připojený, a upraví výchozí značky nebo chování pro konkrétní prohlížeče.

public ref class WebControlAdapter : System::Web::UI::Adapters::ControlAdapter

public class WebControlAdapter : System.Web.UI.Adapters.ControlAdapter

type WebControlAdapter = class
    inherit ControlAdapter

Public Class WebControlAdapter
Inherits ControlAdapter

Dědičnost

Object

ControlAdapter

WebControlAdapter

Odvozené

System.Web.UI.WebControls.Adapters.DataBoundControlAdapter

System.Web.UI.WebControls.Adapters.HideDisabledControlAdapter

System.Web.UI.WebControls.Adapters.HierarchicalDataBoundControlAdapter

System.Web.UI.WebControls.Adapters.MenuAdapter

Poznámky

Třída WebControl je základní třída, ze které webové ovládací prvky dědí. Definuje mnoho vlastností společných pro všechny webové ovládací prvky. Další informace najdete na webu WebControl.

Objekt WebControlAdapter je komponenta, která v životním cyklu provádění nahrazuje určité WebControl třídy nebo zděděné metody a události, které umožňují zpracování specifické pro prohlížeč nebo revize. Rozhraní .NET Framework mapuje jeden řídicí adaptér na odvozený WebControl objekt pro každý požadavek klienta.

Adaptér upraví chování ovládacího prvku pro konkrétní prohlížeč nebo třídu prohlížečů nebo funguje jako libovolný filtr některých funkcí. Velká část adaptability při vykreslování chování lze zapouzdřovat ve specializovaných třídách, které jsou odvozeny od HtmlTextWriter třídy. Proto je pravděpodobné, že jeden adaptér lze použít pro řadu chování třídy prohlížeče nebo zahrnutí adaptability do HtmlTextWriter tříd může vyžadovat použití řídicího adaptéru zbytečné.

Samotné ovládací prvky nemusí nutně vyžadovat adaptér. Pokud jsou ovládací prvky rozšířeny složením, jsou obecně dostačující adaptéry podřízených ovládacích prvků.

Každý ovládací prvek má explicitní mapování na adaptéry prostřednictvím definičních souborů prohlížeče. Proto jakýkoli přístup k Adapter vlastnosti WebControl používá HttpBrowserCapabilities objekt extrahovaný ze souborů definic prohlížeče k provedení vyhledávání mapování adaptéru na řízení.

Během zpracování rozhraní .NET Framework zachycuje volání přepisovatelných metod ovládacího prvku, které by mohly být specifické pro konkrétní cíl. Pokud je připojený řídicí adaptér, rozhraní .NET Framework volá přidružené metody adaptéru. Další informace najdete na webu ControlAdapter.

Vykreslování se WebControl obvykle skládá z počáteční a koncové značky a některých vnitřních značek mezi počátečními a koncovými značkami. Značky jsou definovány při WebControl vytváření. Další informace najdete na webu WebControl.

Značky jsou generovány metodami RenderBeginTag a RenderEndTag metodami. Vnitřní kód je generován metodou RenderContents .

Metoda Render generuje všechny značky voláním metod v následujícím pořadí:

1. RenderBeginTag.

2. RenderContents.

3. RenderEndTag.

Vlastnost IsEnabled vrátí pouze true v případě, že WebControl jsou povoleny všechny nadřazené ovládací prvky. Vlastnost Control vrátí silného typu odkaz na WebControl.

Konstruktory

Name	Description
WebControlAdapter()	Inicializuje novou instanci WebControlAdapter třídy.

Vlastnosti

Name	Description
Browser	Získá odkaz na možnosti prohlížeče klienta, který provádí aktuální požadavek HTTP. (Zděděno od ControlAdapter)
Control	Získá odkaz na webový ovládací prvek, ke kterému je tento adaptér ovládacího prvku připojen.
IsEnabled	Získá hodnotu určující, zda webový ovládací prvek a všechny jeho nadřazené ovládací prvky jsou povoleny.
Page	Získá odkaz na stránku, kde se nachází ovládací prvek přidružený k tomuto adaptéru. (Zděděno od ControlAdapter)
PageAdapter	Získá odkaz na adaptér stránky pro stránku, kde se nachází přidružený ovládací prvek. (Zděděno od ControlAdapter)

Metody

Name	Description
BeginRender(HtmlTextWriter)	Volá se před vykreslováním ovládacího prvku. V odvozené třídě adaptéru vygeneruje otevírání značek, které jsou vyžadovány konkrétním cílem, ale nejsou potřeba v prohlížečích HTML. (Zděděno od ControlAdapter)
CreateChildControls()	Vytvoří podřízené ovládací prvky specifické pro cíl pro složený ovládací prvek. (Zděděno od ControlAdapter)
EndRender(HtmlTextWriter)	Volá se po vykreslení ovládacího prvku. V odvozené třídě adaptéru vygeneruje koncové značky, které jsou vyžadovány konkrétním cílem, ale nejsou potřeba v prohlížečích HTML. (Zděděno od ControlAdapter)
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
LoadAdapterControlState(Object)	Načte informace o stavu řízení adaptéru uložené SaveAdapterControlState() během předchozího požadavku na stránku, kde se nachází ovládací prvek přidružený k tomuto adaptéru ovládacího prvku. (Zděděno od ControlAdapter)
LoadAdapterViewState(Object)	Načte informace o stavu zobrazení adaptéru uložené SaveAdapterViewState() během předchozího požadavku na stránku, kde se nachází ovládací prvek přidružený k tomuto adaptéru ovládacího prvku. (Zděděno od ControlAdapter)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
OnInit(EventArgs)	Přepíše metodu OnInit(EventArgs) přidruženého ovládacího prvku. (Zděděno od ControlAdapter)
OnLoad(EventArgs)	Přepíše metodu OnLoad(EventArgs) přidruženého ovládacího prvku. (Zděděno od ControlAdapter)
OnPreRender(EventArgs)	Přepíše metodu OnPreRender(EventArgs) přidruženého ovládacího prvku. (Zděděno od ControlAdapter)
OnUnload(EventArgs)	Přepíše metodu OnUnload(EventArgs) přidruženého ovládacího prvku. (Zděděno od ControlAdapter)
Render(HtmlTextWriter)	Vygeneruje cílovou značku pro ovládací prvek, ke kterému je adaptér ovládacího prvku připojen.
RenderBeginTag(HtmlTextWriter)	Vytvoří počáteční značku webového ovládacího prvku v kódu, který se přenese do cílového prohlížeče.
RenderChildren(HtmlTextWriter)	Vygeneruje značku specifickou pro cíl pro podřízené ovládací prvky ve složeném ovládacím prvku, ke kterému je adaptér ovládacího prvku připojen. (Zděděno od ControlAdapter)
RenderContents(HtmlTextWriter)	Vygeneruje vnitřní kód specifický pro cíl webového ovládacího prvku, ke kterému je adaptér ovládacího prvku připojen.
RenderEndTag(HtmlTextWriter)	Vytvoří koncovou značku webového ovládacího prvku v kódu, který se přenese do cílového prohlížeče.
SaveAdapterControlState()	Uloží informace o stavu ovládacího prvku pro adaptér ovládacího prvku. (Zděděno od ControlAdapter)
SaveAdapterViewState()	Uloží informace o stavu řídicího adaptéru. (Zděděno od ControlAdapter)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Viz také

• ControlAdapter
• WebControl
• Control