WebControlAdapter Klasse

Definition

Namespace:

System.Web.UI.WebControls.Adapters

Assembly:

System.Web.dll

Passt das Rendering für das Websteuerelement an, an das der Steuerelementadapter angefügt ist, um das Standardmarkup oder Standardverhalten für bestimmte Browser zu ändern.

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

Vererbung

Object

ControlAdapter

WebControlAdapter

Abgeleitet

System.Web.UI.WebControls.Adapters.DataBoundControlAdapter

System.Web.UI.WebControls.Adapters.HideDisabledControlAdapter

System.Web.UI.WebControls.Adapters.HierarchicalDataBoundControlAdapter

System.Web.UI.WebControls.Adapters.MenuAdapter

Hinweise

Die WebControl -Klasse ist die Basisklasse, von der Websteuerelemente erben. Sie definiert viele Eigenschaften, die allen Websteuerelementen gemeinsam sind. Weitere Informationen finden Sie unter WebControl.

Ein -Objekt ist eine Komponente, die bestimmte Klassen oder geerbte Methoden und Ereignisse im Ausführungslebenszyklus ersetzt, um browser- oder WebControlAdapter WebControl markupspezifische Behandlung zu ermöglichen. Die .NET Framework ordnet für jede Clientanforderung einem abgeleiteten WebControl Objekt einen einzelnen Steuerelementadapter zu.

Ein Adapter ändert ein Steuerelementverhalten für einen bestimmten Browser oder eine bestimmte Browserklasse oder fungiert als beliebiger Filter für eine Funktion. Ein Teil der Anpassungsfähigkeit des Renderingverhaltens kann in den spezialisierten Klassen gekapselt werden, die von der -Klasse HtmlTextWriter ableiten. Daher ist es wahrscheinlich, dass ein einzelner Adapter für eine Reihe von Browserklassenverhalten verwendet werden kann oder dass die Einbeziehung der Anpassungsfähigkeit in die Klassen die Verwendung eines Steuerelementadapters unnötig HtmlTextWriter machen könnte.

Steuerelemente selbst erfordern nicht unbedingt einen Adapter. Wenn Steuerelemente durch Komposition erweitert werden, sind im Allgemeinen die Adapter für die untergeordneten Steuerelemente ausreichend.

Jedes Steuerelement verfügt über explizite Zuordnungen zu Adaptern über die BROWSER-Definitionsdateien. Daher verwendet jeder Zugriff auf die -Eigenschaft von das -Objekt, das aus den BROWSER-Definitionsdateien extrahiert wurde, um die Suche nach der Zuordnung des zu steuernden Adapter WebControl HttpBrowserCapabilities Adapters durchzuführen.

Während der Verarbeitung fängt .NET Framework Aufrufe der überschreibbaren Methoden eines Steuerelements ab, die zielspezifisch sein könnten. Wenn ein Steuerelementadapter angefügt ist, ruft .NET Framework die zugeordneten Adaptermethoden auf. Weitere Informationen finden Sie unter ControlAdapter.

Das Rendering für ein besteht in der Regel aus einem Start- und Endtag sowie aus einem inneren Markup zwischen den WebControl Anfangs- und Endtags. Die Tags werden definiert, wenn WebControl erstellt wird. Weitere Informationen finden Sie unter WebControl.

Die Tags werden generiert, indem die RenderBeginTag und RenderEndTag Methoden bzw. Das innere Markup wird von der -Methode RenderContents generiert.

Die Render -Methode generiert alle Markups, indem sie Methoden in der folgenden Reihenfolge aufruft:

1. RenderBeginTag.

2. RenderContents.

3. RenderEndTag.

Die IsEnabled -Eigenschaft gibt true nur dann zurück, wenn und alle WebControl übergeordneten Steuerelemente aktiviert sind. Die Control -Eigenschaft gibt einen stark typierten Verweis auf WebControl zurück.

Konstruktoren

WebControlAdapter()

Initialisiert eine neue Instanz der WebControlAdapter-Klasse.

Eigenschaften

Browser	Ruft einen Verweis auf die Browserfunktionen des Clients ab, durch den die aktuelle HTTP-Anforderung erfolgt. (Geerbt von ControlAdapter)
Control	Ruft einen Verweis auf das Websteuerelement ab, an das dieser Steuerelementadapter angefügt ist.
IsEnabled	Ruft einen Wert ab, der angibt, ob das Websteuerelement und alle übergeordneten Steuerelemente aktiviert sind.
Page	Ruft einen Verweis auf die Seite ab, auf der sich das diesem Adapter zugeordnete Steuerelement befindet. (Geerbt von ControlAdapter)
PageAdapter	Ruft einen Verweis auf den Seitenadapter für die Seite ab, auf der sich das zugeordnete Steuerelement befindet. (Geerbt von ControlAdapter)

Methoden

BeginRender(HtmlTextWriter)	Wird vor dem Rendering eines Steuerelements aufgerufen. Generiert in einer abgeleiteten Adapterklasse öffnende Tags, die für ein bestimmtes Ziel erforderlich sind, von HTML-Browsern jedoch nicht benötigt werden. (Geerbt von ControlAdapter)
CreateChildControls()	Erstellt die zielspezifischen untergeordneten Steuerelemente für ein zusammengesetztes Steuerelement. (Geerbt von ControlAdapter)
EndRender(HtmlTextWriter)	Wird nach dem Rendering eines Steuerelements aufgerufen. Generiert in einer abgeleiteten Adapterklasse schließende Tags, die für ein bestimmtes Ziel erforderlich sind, von HTML-Browsern jedoch nicht benötigt werden. (Geerbt von ControlAdapter)
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
LoadAdapterControlState(Object)	Lädt Steuerelementzustandsinformationen des Adapters, die von SaveAdapterControlState() während einer vorherigen Anforderung der Seite, auf der sich das diesem Steuerelementadapter zugeordnete Steuerelement befindet, gespeichert wurden. (Geerbt von ControlAdapter)
LoadAdapterViewState(Object)	Lädt Ansichtszustandsinformationen des Adapters, die von SaveAdapterViewState() während einer vorherigen Anforderung der Seite, auf der sich das diesem Steuerelementadapter zugeordnete Steuerelement befindet, gespeichert wurden. (Geerbt von ControlAdapter)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
OnInit(EventArgs)	Überschreibt die OnInit(EventArgs)-Methode für das zugeordnete Steuerelement. (Geerbt von ControlAdapter)
OnLoad(EventArgs)	Überschreibt die OnLoad(EventArgs)-Methode für das zugeordnete Steuerelement. (Geerbt von ControlAdapter)
OnPreRender(EventArgs)	Überschreibt die OnPreRender(EventArgs)-Methode für das zugeordnete Steuerelement. (Geerbt von ControlAdapter)
OnUnload(EventArgs)	Überschreibt die OnUnload(EventArgs)-Methode für das zugeordnete Steuerelement. (Geerbt von ControlAdapter)
Render(HtmlTextWriter)	Generiert das zielspezifische Markup für das Steuerelement, an das der Steuerelementadapter angefügt ist.
RenderBeginTag(HtmlTextWriter)	Erstellt das Anfangstag für das Websteuerelement im Markup, das an den Zielbrowser übertragen wird.
RenderChildren(HtmlTextWriter)	Generiert das zielspezifische Markup für die untergeordneten Steuerelemente in einem zusammengesetzten Steuerelement, an das der Steuerelementadapter angefügt ist. (Geerbt von ControlAdapter)
RenderContents(HtmlTextWriter)	Generiert das zielspezifische innere Markup für das Websteuerelement, an das der Steuerelementadapter angefügt wird.
RenderEndTag(HtmlTextWriter)	Erstellt das Endtag für das Websteuerelement im Markup, das an den Zielbrowser übertragen wird.
SaveAdapterControlState()	Speichert Steuerelementzustandsinformationen für den Steuerelementadapter. (Geerbt von ControlAdapter)
SaveAdapterViewState()	Speichert Ansichtszustandsinformationen für den Steuerelementadapter. (Geerbt von ControlAdapter)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Siehe auch

• ControlAdapter
• WebControl
• Control