WebControlAdapter Klasa

Definicja

Przestrzeń nazw:

System.Web.UI.WebControls.Adapters

Zestaw:

System.Web.dll

Dostosowuje renderowanie kontrolki sieci Web, do której jest dołączona karta sterowa, w celu zmodyfikowania domyślnego znaczników lub zachowania dla określonych przeglądarek.

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

Dziedziczenie

Object

ControlAdapter

WebControlAdapter

Pochodne

System.Web.UI.WebControls.Adapters.DataBoundControlAdapter

System.Web.UI.WebControls.Adapters.HideDisabledControlAdapter

System.Web.UI.WebControls.Adapters.HierarchicalDataBoundControlAdapter

System.Web.UI.WebControls.Adapters.MenuAdapter

Uwagi

Klasa WebControl jest klasą bazową, z której kontrolki sieci Web dziedziczą. Definiuje wiele właściwości wspólnych dla wszystkich kontrolek sieci Web. Aby uzyskać więcej informacji, zobacz WebControl.

WebControlAdapter Obiekt jest składnikiem, który zastępuje niektóre WebControl metody lub dziedziczone metody i zdarzenia w cyklu życia wykonywania, aby umożliwić obsługę specyficzną dla przeglądarki lub znaczników. Program .NET Framework mapuje pojedynczą kartę sterową na obiekt pochodny WebControl dla każdego żądania klienta.

Adapter modyfikuje zachowanie kontrolki dla określonej przeglądarki lub klasy przeglądarek lub działa jako dowolny filtr niektórych funkcji. Wiele możliwości adaptacji w zachowaniu renderowania można hermetyzować w wyspecjalizowanych klasach, które pochodzą z HtmlTextWriter klasy. W związku z tym istnieje prawdopodobieństwo, że jedna karta może być używana w wielu zachowaniach klasy przeglądarki lub włączenie dostosowania w HtmlTextWriter klasach może spowodować niepotrzebne użycie adaptera sterującego.

Same kontrolki nie muszą wymagać adaptera. Jeśli kontrolki są rozszerzone przez kompozycję, ogólnie karty dla kontrolek podrzędnych są wystarczające.

Każda kontrolka ma jawne mapowania na karty za pośrednictwem plików definicji przeglądarki. W związku z tym każdy dostęp do Adapter właściwości WebControl używa HttpBrowserCapabilities obiektu wyodrębnionego z plików definicji przeglądarki w celu wykonania wyszukiwania mapowania adaptera do sterowania.

Podczas przetwarzania program .NET Framework przechwytuje wywołania do zastępowalnych metod kontrolki, które mogą być specyficzne dla elementu docelowego. Jeśli karta sterowa jest dołączona, program .NET Framework wywołuje skojarzone metody adaptera. Aby uzyskać więcej informacji, zobacz ControlAdapter.

Renderowanie elementu zwykle WebControl składa się z tagu początkowego i końcowego, a niektóre wewnętrzne znaczniki między tagami początkowymi i końcowymi. Tagi są definiowane podczas WebControl tworzenia. Aby uzyskać więcej informacji, zobacz WebControl.

Tagi są generowane odpowiednio przez RenderBeginTag metody i RenderEndTag . Wewnętrzny znacznik jest generowany przez metodę RenderContents .

Metoda Render generuje wszystkie znaczniki, wywołując metody w następującej kolejności:

1. RenderBeginTag.

2. RenderContents.

3. RenderEndTag.

Właściwość IsEnabled zwraca true tylko wtedy, gdy WebControl wszystkie jej kontrolki nadrzędne są włączone. Właściwość Control zwraca silnie typizowane odwołanie do obiektu WebControl.

Konstruktory

Nazwa	Opis
WebControlAdapter()	Inicjuje nowe wystąpienie klasy WebControlAdapter.

Właściwości

Nazwa	Opis
Browser	Pobiera odwołanie do możliwości przeglądarki klienta wysyłającego bieżące żądanie HTTP. (Odziedziczone po ControlAdapter)
Control	Pobiera odwołanie do kontrolki sieci Web, do której jest dołączona ta karta sterowa.
IsEnabled	Pobiera wartość wskazującą, czy kontrolka sieci Web i wszystkie jej kontrolki nadrzędne są włączone.
Page	Pobiera odwołanie do strony, na której znajduje się kontrolka skojarzona z tą kartą. (Odziedziczone po ControlAdapter)
PageAdapter	Pobiera odwołanie do karty strony dla strony, na której znajduje się skojarzona kontrolka. (Odziedziczone po ControlAdapter)

Metody

Nazwa	Opis
BeginRender(HtmlTextWriter)	Wywoływane przed renderowaniem kontrolki. W klasie karty pochodnej generuje tagi otwierające, które są wymagane przez określony element docelowy, ale nie jest wymagany przez przeglądarki HTML. (Odziedziczone po ControlAdapter)
CreateChildControls()	Tworzy kontrolki podrzędne specyficzne dla elementu docelowego dla złożonej kontrolki. (Odziedziczone po ControlAdapter)
EndRender(HtmlTextWriter)	Wywołana po renderowaniu kontrolki. W klasie adaptera pochodnego generuje tagi zamykające, które są wymagane przez określony element docelowy, ale nie jest wymagany przez przeglądarki HTML. (Odziedziczone po ControlAdapter)
Equals(Object)	Określa, czy określony obiekt jest równy bieżącemu obiektowi. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Pobiera Type bieżącego wystąpienia. (Odziedziczone po Object)
LoadAdapterControlState(Object)	Ładuje informacje o stanie kontrolki karty, które zostały zapisane SaveAdapterControlState() podczas poprzedniego żądania na stronie, na której znajduje się kontrolka skojarzona z tą kartą sterowania. (Odziedziczone po ControlAdapter)
LoadAdapterViewState(Object)	Ładuje informacje o stanie widoku karty, które zostały zapisane SaveAdapterViewState() podczas poprzedniego żądania na stronie, na której znajduje się kontrolka skojarzona z tą kartą sterowania. (Odziedziczone po ControlAdapter)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Object. (Odziedziczone po Object)
OnInit(EventArgs)	Zastępuje metodę OnInit(EventArgs) skojarzonej kontrolki. (Odziedziczone po ControlAdapter)
OnLoad(EventArgs)	Zastępuje metodę OnLoad(EventArgs) skojarzonej kontrolki. (Odziedziczone po ControlAdapter)
OnPreRender(EventArgs)	Zastępuje metodę OnPreRender(EventArgs) skojarzonej kontrolki. (Odziedziczone po ControlAdapter)
OnUnload(EventArgs)	Zastępuje metodę OnUnload(EventArgs) skojarzonej kontrolki. (Odziedziczone po ControlAdapter)
Render(HtmlTextWriter)	Generuje znaczniki specyficzne dla elementu docelowego dla kontrolki, do której jest dołączona karta sterowa.
RenderBeginTag(HtmlTextWriter)	Tworzy tag początkowy dla kontrolki Sieci Web w znacznikach przesyłanych do przeglądarki docelowej.
RenderChildren(HtmlTextWriter)	Generuje znaczniki specyficzne dla elementu docelowego dla kontrolek podrzędnych w złożonej kontrolce, do której jest dołączona karta sterowa. (Odziedziczone po ControlAdapter)
RenderContents(HtmlTextWriter)	Generuje znacznik wewnętrzny specyficzny dla elementu docelowego dla kontrolki sieci Web, do której jest dołączona karta sterowa.
RenderEndTag(HtmlTextWriter)	Tworzy tag końcowy dla kontrolki Sieci Web w znaczniku przesyłanym do przeglądarki docelowej.
SaveAdapterControlState()	Zapisuje informacje o stanie kontrolki dla karty sterującej. (Odziedziczone po ControlAdapter)
SaveAdapterViewState()	Zapisuje informacje o stanie widoku dla karty sterującej. (Odziedziczone po ControlAdapter)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Zobacz też

• ControlAdapter
• WebControl
• Control