WebControlAdapter Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.UI.WebControls.Adapters

Zestaw:: System.Web.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Dostosowuje renderowanie kontrolki sieci Web, do której jest dołączona karta sterowania, w celu zmodyfikowania domyślnego znacznika 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 dziedziczą kontrolki internetowe. Definiuje wiele właściwości wspólnych dla wszystkich kontrolek internetowych. Aby uzyskać więcej informacji, zobacz WebControl.

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

Karta modyfikuje zachowanie kontrolki dla określonej przeglądarki lub klasy przeglądarek albo działa jako dowolny filtr dla niektórych funkcji. Większość możliwości dostosowania w zachowaniu renderowania można zhermetyzować 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 do obsługi wielu zachowań klas przeglądarki lub uwzględnienie możliwości dostosowania w klasach może spowodować, że użycie karty sterującej będzie HtmlTextWriter niepotrzebne.

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

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

Podczas przetwarzania .NET Framework przechwytuje wywołania metod, które można zastąpić kontrolki, które mogą być specyficzne dla celu. Jeśli karta sterowa jest dołączona, .NET Framework wywołuje skojarzone metody karty. Aby uzyskać więcej informacji, zobacz ControlAdapter.

Renderowanie dla tagu zwykle składa się z tagu początku i końca oraz pewnych wewnętrznych znaczników między tagami początku WebControl i końca. Tagi są definiowane podczas WebControl tworzenia. Aby uzyskać więcej informacji, zobacz WebControl.

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

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

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

Konstruktory

WebControlAdapter()

Inicjuje nowe wystąpienie klasy WebControlAdapter.

Właściwości

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 Internetowa 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

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 kontrolki złożonej. (Odziedziczone po ControlAdapter)
EndRender(HtmlTextWriter)	Wywoływana po renderowaniu kontrolki. W klasie pochodnej karty 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 dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Type Pobiera wartość 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 Objectelementu . (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 znacznik specyficzny dla obiektu docelowego dla kontrolki, do której jest dołączona karta sterowania.
RenderBeginTag(HtmlTextWriter)	Tworzy tag początku kontrolki internetowej w znaczniku, który jest przesyłany do przeglądarki docelowej.
RenderChildren(HtmlTextWriter)	Generuje znaczniki specyficzne dla elementu docelowego dla kontrolek podrzędnych w kontrolce złożonej, do której jest dołączony adapter sterujący. (Odziedziczone po ControlAdapter)
RenderContents(HtmlTextWriter)	Generuje wewnętrzny znacznik specyficzny dla określonego obiektu docelowego dla kontrolki internetowej, do której jest dołączona karta sterowania.
RenderEndTag(HtmlTextWriter)	Tworzy tag końcowy kontrolki Internetowej w znaczniku, który jest przesyłany do przeglądarki docelowej.
SaveAdapterControlState()	Zapisuje informacje o stanie sterowania 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)

Dotyczy

Udostępnij za pośrednictwem