WebControlAdapter Classe

Riferimento

Definizione

Spazio dei nomi:: System.Web.UI.WebControls.Adapters

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Personalizza il rendering per il controllo Web a cui è associato l'adattatore di controllo per modificare il comportamento o il markup predefinito per browser specifici.

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

Ereditarietà: Object

ControlAdapter
WebControlAdapter

Derivato: System.Web.UI.WebControls.Adapters.DataBoundControlAdapter

System.Web.UI.WebControls.Adapters.HideDisabledControlAdapter

System.Web.UI.WebControls.Adapters.HierarchicalDataBoundControlAdapter

System.Web.UI.WebControls.Adapters.MenuAdapter

Commenti

La WebControl classe è la classe di base da cui ereditano i controlli Web. Definisce molte proprietà comuni a tutti i controlli Web. Per altre informazioni, vedere WebControl.

Un oggetto è un componente che sostituisce determinati metodi ed eventi ereditati o di classe nel ciclo di vita di esecuzione per consentire la gestione specifica del browser o WebControlAdapter WebControl del markup. La .NET Framework esegue il mapping di un singolo adattatore di controllo a un WebControl oggetto derivato per ogni richiesta client.

Un adattatore modifica un comportamento del controllo per un browser o una classe specifica di browser o funge da filtro arbitrario per alcune funzionalità. Gran parte dell'adattabilità nel comportamento di rendering può essere incapsulata nelle classi specializzate che derivano dalla HtmlTextWriter classe . Di conseguenza, è probabile che sia possibile usare un singolo adattatore per diversi comportamenti delle classi del browser o che l'inclusione dell'adattabilità nelle classi potrebbe rendere superfluo l'uso di un HtmlTextWriter adattatore di controllo.

I controlli stessi non richiedono necessariamente un adattatore. Se i controlli vengono estesi tramite composizione, in genere sono sufficienti gli adattatori per i controlli figlio.

Ogni controllo ha mapping espliciti agli adattatori tramite i file di definizione del browser. Pertanto, qualsiasi accesso alla proprietà di usa l'oggetto estratto dai file di definizione del browser per eseguire la ricerca del Adapter mapping dell'adattatore WebControl da HttpBrowserCapabilities controllare.

Durante l'elaborazione, .NET Framework intercetta le chiamate ai metodi sottoponibili a override di un controllo che potrebbe essere specifico della destinazione. Se un adattatore di controllo è collegato, il .NET Framework chiama i metodi dell'adattatore associato. Per altre informazioni, vedere ControlAdapter.

Il rendering per un oggetto è in genere costituito da un tag di inizio e di fine e da un WebControl markup interno tra i tag di inizio e di fine. I tag vengono definiti al momento WebControl della creazione di . Per altre informazioni, vedere WebControl.

I tag vengono generati rispettivamente RenderBeginTag RenderEndTag dai metodi e . Il markup interno viene generato dal RenderContents metodo .

Il Render metodo genera tutto il markup chiamando i metodi nell'ordine seguente:

La IsEnabled proprietà restituisce solo se true WebControl l'oggetto e tutti i relativi controlli padre sono abilitati. La Control proprietà restituisce un riferimento fortemente tipizzato a WebControl .

Costruttori

WebControlAdapter()

Inizializza una nuova istanza della classe WebControlAdapter.

Proprietà

Browser	Ottiene un riferimento alle funzionalità del browser del client che effettua la richiesta HTTP corrente. (Ereditato da ControlAdapter)
Control	Ottiene un riferimento al controllo Web a cui è associato questo adattatore di controllo.
IsEnabled	Ottiene un valore che indica se il controllo Web e tutti i relativi controlli padre sono abilitati.
Page	Ottiene un riferimento alla pagina in cui si trova il controllo associato a questo adattatore. (Ereditato da ControlAdapter)
PageAdapter	Ottiene un riferimento all'adattatore di pagina per la pagina in cui si trova il controllo associato. (Ereditato da ControlAdapter)

Metodi

BeginRender(HtmlTextWriter)	Questo metodo viene chiamato prima di effettuare il rendering di un controllo. In una classe di adattatore derivata, genera i tag di apertura richiesti da una destinazione specifica ma non necessari per i browser HTML. (Ereditato da ControlAdapter)
CreateChildControls()	Crea i controlli figlio specifici della destinazione per un controllo composito. (Ereditato da ControlAdapter)
EndRender(HtmlTextWriter)	Questo metodo viene chiamato dopo il rendering di un controllo. In una classe di adattatore derivata, genera i tag di chiusura richiesti da una destinazione specifica ma non necessari per i browser HTML. (Ereditato da ControlAdapter)
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
LoadAdapterControlState(Object)	Carica le informazioni sullo stato di controllo dell'adattatore salvate dal metodo SaveAdapterControlState() durante una precedente richiesta alla pagina in cui si trova il controllo associato a questo adattatore di controllo. (Ereditato da ControlAdapter)
LoadAdapterViewState(Object)	Carica le informazioni sullo stato di visualizzazione dell'adattatore salvate dal metodo SaveAdapterViewState() durante una precedente richiesta alla pagina in cui si trova il controllo associato a questo adattatore di controllo. (Ereditato da ControlAdapter)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
OnInit(EventArgs)	Esegue l'override del metodo OnInit(EventArgs) per il controllo associato. (Ereditato da ControlAdapter)
OnLoad(EventArgs)	Esegue l'override del metodo OnLoad(EventArgs) per il controllo associato. (Ereditato da ControlAdapter)
OnPreRender(EventArgs)	Esegue l'override del metodo OnPreRender(EventArgs) per il controllo associato. (Ereditato da ControlAdapter)
OnUnload(EventArgs)	Esegue l'override del metodo OnUnload(EventArgs) per il controllo associato. (Ereditato da ControlAdapter)
Render(HtmlTextWriter)	Genera il markup specifico della destinazione per il controllo a cui è associato l'adattatore del controllo.
RenderBeginTag(HtmlTextWriter)	Crea il tag di inizio per il controllo Web nel markup trasmesso al browser di destinazione.
RenderChildren(HtmlTextWriter)	Genera il markup specifico della destinazione per i controlli figlio in un controllo composito al quale è collegato l'adattatore del controllo. (Ereditato da ControlAdapter)
RenderContents(HtmlTextWriter)	Genera il markup interno specifico della destinazione per il controllo Web a cui è associato l'adattatore di controllo.
RenderEndTag(HtmlTextWriter)	Crea il tag di fine per il controllo Web nel markup trasmesso al browser di destinazione.
SaveAdapterControlState()	Salva le informazioni sullo stato del controllo per l'adattatore del controllo. (Ereditato da ControlAdapter)
SaveAdapterViewState()	Salva le informazioni sullo stato di visualizzazione per l'adattatore del controllo. (Ereditato da ControlAdapter)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Si applica a