WebControlAdapter Classe

Definizione

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.Customizes rendering for the Web control to which the control adapter is attached, to modify the default markup or behavior for specific browsers.

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à
WebControlAdapter
Derivato

Commenti

La WebControl classe è la classe base da cui ereditano i controlli Web.The WebControl class is the base class from which Web controls inherit. Definisce molte proprietà comuni a tutti i controlli Web.It defines many properties common to all Web controls. Per ulteriori informazioni, vedere WebControl.For more information, see WebControl.

Un WebControlAdapter oggetto è un componente che sostituisce determinati WebControl metodi ed eventi ereditati nel ciclo di vita dell'esecuzione per consentire la gestione specifica del browser o del markup.A WebControlAdapter object is a component that substitutes certain WebControl class or inherited methods and events in its execution life cycle to allow browser- or markup-specific handling. Il .NET Framework esegue il mapping di un adattatore di controllo WebControl singolo a un oggetto derivato per ogni richiesta del client.The .NET Framework maps a single control adapter to a derived WebControl object for each client request.

Un adapter modifica un comportamento di controllo per un browser o una classe di browser specifici o funge da filtro arbitrario per alcune funzionalità.An adapter modifies a control behavior for a specific browser or class of browsers or acts as an arbitrary filter on some capability. Gran parte dell'adattamento nel comportamento di rendering può essere incapsulato nelle classi specializzate che derivano HtmlTextWriter dalla classe.Much of the adaptability in rendering behavior can be encapsulated in the specialized classes that derive from the HtmlTextWriter class. Pertanto, è probabile che sia possibile utilizzare un singolo adapter per diversi comportamenti della classe del browser o che l'inclusione dell'adattamento nelle HtmlTextWriter classi possa rendere superfluo l'utilizzo di un adattatore di controllo.Therefore, it is likely that a single adapter can be used for a number of browser class behaviors or that inclusion of the adaptability in the HtmlTextWriter classes might make the use of a control adapter unnecessary.

I controlli stessi non richiedono necessariamente un adapter.Controls themselves do not necessarily require an adapter. Se i controlli vengono estesi tramite la composizione, in genere gli adapter per i controlli figlio sono sufficienti.If controls are extended through composition, generally the adapters for the child controls are sufficient.

Ogni controllo dispone di mapping espliciti agli adapter tramite i file di definizione del browser.Each control has explicit mappings to adapters through the .browser definition files. Pertanto, qualsiasi accesso alla Adapter proprietà di WebControl utilizza l' HttpBrowserCapabilities oggetto estratto dai file di definizione del browser per eseguire la ricerca del mapping dell'adapter al controllo.Thus, any access to the Adapter property of WebControl uses the HttpBrowserCapabilities object extracted from the .browser definition files to perform the lookup for the mapping of the adapter to control.

Durante l'elaborazione, il .NET Framework intercetta le chiamate ai metodi sottoponibili a override di un controllo che possono essere specifici della destinazione.During processing, the .NET Framework intercepts calls to the overridable methods of a control that could be target-specific. Se un adattatore di controllo è collegato, il .NET Framework chiama i metodi dell'adapter associati.If a control adapter is attached, the .NET Framework calls the associated adapter methods. Per ulteriori informazioni, vedere ControlAdapter.For more information, see ControlAdapter.

Il rendering per un WebControl oggetto è in genere costituito da un tag di inizio e di fine e da un markup interno tra i tag di inizio e di fine.The rendering for a WebControl typically consists of a beginning and ending tag, and some inner markup between the beginning and ending tags. I tag vengono definiti quando viene WebControl creato l'oggetto.The tags are defined when the WebControl is created. Per ulteriori informazioni, vedere WebControl.For more information, see WebControl.

I tag vengono generati rispettivamente dai RenderBeginTag metodi RenderEndTag e.The tags are generated by the RenderBeginTag and RenderEndTag methods, respectively. Il markup interno viene generato dal RenderContents metodo.The inner markup is generated by the RenderContents method.

Il Render metodo genera tutti i markup, chiamando i metodi nell'ordine seguente:The Render method generates all markup, by calling methods in the following order:

  1. RenderBeginTag.RenderBeginTag.

  2. RenderContents.RenderContents.

  3. RenderEndTag.RenderEndTag.

La IsEnabled proprietà restituisce true solo se WebControl e tutti i relativi controlli padre sono abilitati.The IsEnabled property returns true only if the WebControl and all its parent controls are enabled. La Control proprietà restituisce un riferimento fortemente tipizzato WebControla.The Control property returns a strongly typed reference to the WebControl.

Costruttori

WebControlAdapter()

Inizializza una nuova istanza della classe WebControlAdapter.Initializes a new instance of the WebControlAdapter class.

Proprietà

Browser

Ottiene un riferimento alle funzionalità del browser del client che effettua la richiesta HTTP corrente.Gets a reference to the browser capabilities of the client making the current HTTP request.

(Ereditato da ControlAdapter)
Control

Ottiene un riferimento al controllo Web a cui è associato questo adattatore di controllo.Gets a reference to the Web control to which this control adapter is attached.

IsEnabled

Ottiene un valore che indica se il controllo Web e tutti i relativi controlli padre sono abilitati.Gets a value indicating whether the Web control and all its parent controls are enabled.

Page

Ottiene un riferimento alla pagina in cui si trova il controllo associato a questo adattatore.Gets a reference to the page where the control associated with this adapter resides.

(Ereditato da ControlAdapter)
PageAdapter

Ottiene un riferimento all'adattatore di pagina per la pagina in cui si trova il controllo associato.Gets a reference to the page adapter for the page where the associated control resides.

(Ereditato da ControlAdapter)

Metodi

BeginRender(HtmlTextWriter)

Questo metodo viene chiamato prima di effettuare il rendering di un controllo.Called prior to the rendering of a control. In una classe di adattatore derivata, genera i tag di apertura richiesti da una destinazione specifica ma non necessari per i browser HTML.In a derived adapter class, generates opening tags that are required by a specific target but not needed by HTML browsers.

(Ereditato da ControlAdapter)
CreateChildControls()

Crea i controlli figlio specifici della destinazione per un controllo composito.Creates the target-specific child controls for a composite control.

(Ereditato da ControlAdapter)
EndRender(HtmlTextWriter)

Questo metodo viene chiamato dopo il rendering di un controllo.Called after the rendering of a control. In una classe di adattatore derivata, genera i tag di chiusura richiesti da una destinazione specifica ma non necessari per i browser HTML.In a derived adapter class, generates closing tags that are required by a specific target but not needed by HTML browsers.

(Ereditato da ControlAdapter)
Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(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.Loads adapter control state information that was saved by SaveAdapterControlState() during a previous request to the page where the control associated with this control adapter resides.

(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.Loads adapter view state information that was saved by SaveAdapterViewState() during a previous request to the page where the control associated with this control adapter resides.

(Ereditato da ControlAdapter)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
OnInit(EventArgs)

Esegue l'override del metodo OnInit(EventArgs) per il controllo associato.Overrides the OnInit(EventArgs) method for the associated control.

(Ereditato da ControlAdapter)
OnLoad(EventArgs)

Esegue l'override del metodo OnLoad(EventArgs) per il controllo associato.Overrides the OnLoad(EventArgs) method for the associated control.

(Ereditato da ControlAdapter)
OnPreRender(EventArgs)

Esegue l'override del metodo OnPreRender(EventArgs) per il controllo associato.Overrides the OnPreRender(EventArgs) method for the associated control.

(Ereditato da ControlAdapter)
OnUnload(EventArgs)

Esegue l'override del metodo OnUnload(EventArgs) per il controllo associato.Overrides the OnUnload(EventArgs) method for the associated control.

(Ereditato da ControlAdapter)
Render(HtmlTextWriter)

Genera il markup specifico della destinazione per il controllo a cui è associato l'adattatore del controllo.Generates the target-specific markup for the control to which the control adapter is attached.

RenderBeginTag(HtmlTextWriter)

Crea il tag di inizio per il controllo Web nel markup trasmesso al browser di destinazione.Creates the beginning tag for the Web control in the markup that is transmitted to the target browser.

RenderChildren(HtmlTextWriter)

Genera il markup specifico della destinazione per i controlli figlio in un controllo composito al quale è collegato l'adattatore del controllo.Generates the target-specific markup for the child controls in a composite control to which the control adapter is attached.

(Ereditato da ControlAdapter)
RenderContents(HtmlTextWriter)

Genera il markup interno specifico della destinazione per il controllo Web a cui è associato l'adattatore di controllo.Generates the target-specific inner markup for the Web control to which the control adapter is attached.

RenderEndTag(HtmlTextWriter)

Crea il tag di fine per il controllo Web nel markup trasmesso al browser di destinazione.Creates the ending tag for the Web control in the markup that is transmitted to the target browser.

SaveAdapterControlState()

Salva le informazioni sullo stato del controllo per l'adattatore del controllo.Saves control state information for the control adapter.

(Ereditato da ControlAdapter)
SaveAdapterViewState()

Salva le informazioni sullo stato di visualizzazione per l'adattatore del controllo.Saves view state information for the control adapter.

(Ereditato da ControlAdapter)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Ereditato da Object)

Si applica a

Vedi anche