WebControlAdapter Classe
Definizione
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 è collegato l'adattatore di controllo, per modificare il markup o il comportamento predefinito per browser specifici.
public ref class WebControlAdapter : System::Web::UI::Adapters::ControlAdapterpublic class WebControlAdapter : System.Web.UI.Adapters.ControlAdaptertype WebControlAdapter = class
inherit ControlAdapterPublic Class WebControlAdapter
Inherits ControlAdapter- Ereditarietà
- Derivato
Commenti
La WebControl classe è la classe base da cui ereditano i controlli Web. Definisce molte proprietà comuni a tutti i controlli Web. Per altre informazioni, vedere WebControl.
Un WebControlAdapter oggetto è un componente che sostituisce determinate WebControl classi o metodi e eventi ereditati nel ciclo di vita dell'esecuzione per consentire la gestione specifica del browser o del markup. .NET Framework esegue il mapping di un singolo adattatore di controllo a un oggetto derivato WebControl per ogni richiesta client.
Un adattatore modifica un comportamento di 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 . Pertanto, è probabile che una singola scheda possa essere usata per diversi comportamenti della classe del browser o che l'inclusione dell'adattabilità nelle HtmlTextWriter classi potrebbe rendere superfluo l'uso di un adattatore di controllo.
I controlli stessi non richiedono necessariamente un adattatore. Se i controlli vengono estesi attraverso la composizione, in genere gli adattatori per i controlli figlio sono sufficienti.
Ogni controllo ha mapping espliciti agli adapter tramite i file di definizione del browser. Pertanto, qualsiasi accesso alla Adapter proprietà di WebControl utilizza l'oggetto HttpBrowserCapabilities estratto dai file di definizione del browser per eseguire la ricerca per il mapping dell'adattatore al controllo.
Durante l'elaborazione, .NET Framework intercetta le chiamate ai metodi sostituibili di un controllo che potrebbe essere specifico della destinazione. Se un adattatore di controllo è collegato, .NET Framework chiama i metodi dell'adattatore associati. Per altre informazioni, vedere ControlAdapter.
Il rendering per un WebControl oggetto è in genere costituito da un tag iniziale e finale e da un markup interno tra i tag iniziali e finali. I tag vengono definiti quando viene creato .WebControl Per altre informazioni, vedere WebControl.
I tag vengono generati rispettivamente dai RenderBeginTag metodi e RenderEndTag . 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 true solo se WebControl e tutti i relativi controlli padre sono abilitati. La Control proprietà restituisce un riferimento fortemente tipizzato all'oggetto WebControl.
Costruttori
| Nome | Descrizione |
|---|---|
| WebControlAdapter() |
Inizializza una nuova istanza della classe WebControlAdapter. |
Proprietà
| Nome | Descrizione |
|---|---|
| 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 è collegato l'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 risiede il controllo associato all'adattatore. (Ereditato da ControlAdapter) |
| PageAdapter |
Ottiene un riferimento all'adattatore di pagina per la pagina in cui risiede il controllo associato. (Ereditato da ControlAdapter) |
Metodi
| Nome | Descrizione |
|---|---|
| BeginRender(HtmlTextWriter) |
Chiamato prima del rendering di un controllo. In una classe adapter derivata genera 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) |
Chiamato dopo il rendering di un controllo. In una classe adapter derivata genera 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 il Type dell'istanza corrente. (Ereditato da Object) |
| LoadAdapterControlState(Object) |
Carica le informazioni sullo stato del controllo adattatore salvate da SaveAdapterControlState() durante una richiesta precedente alla pagina in cui risiede il controllo associato a questo adattatore di controllo. (Ereditato da ControlAdapter) |
| LoadAdapterViewState(Object) |
Carica le informazioni sullo stato di visualizzazione dell'adattatore salvate da SaveAdapterViewState() durante una richiesta precedente alla pagina in cui risiede il controllo associato a questo adattatore di controllo. (Ereditato da ControlAdapter) |
| MemberwiseClone() |
Crea una copia superficiale del Objectcorrente. (Ereditato da Object) |
| OnInit(EventArgs) |
Esegue l'override del OnInit(EventArgs) metodo per il controllo associato. (Ereditato da ControlAdapter) |
| OnLoad(EventArgs) |
Esegue l'override del OnLoad(EventArgs) metodo per il controllo associato. (Ereditato da ControlAdapter) |
| OnPreRender(EventArgs) |
Esegue l'override del OnPreRender(EventArgs) metodo per il controllo associato. (Ereditato da ControlAdapter) |
| OnUnload(EventArgs) |
Esegue l'override del OnUnload(EventArgs) metodo per il controllo associato. (Ereditato da ControlAdapter) |
| Render(HtmlTextWriter) |
Genera il markup specifico della destinazione per il controllo a cui è collegato l'adattatore di controllo. |
| RenderBeginTag(HtmlTextWriter) |
Crea il tag iniziale 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 a cui è collegato l'adattatore di controllo. (Ereditato da ControlAdapter) |
| RenderContents(HtmlTextWriter) |
Genera il markup interno specifico della destinazione per il controllo Web a cui è collegato l'adattatore di controllo. |
| RenderEndTag(HtmlTextWriter) |
Crea il tag finale per il controllo Web nel markup trasmesso al browser di destinazione. |
| SaveAdapterControlState() |
Salva le informazioni sullo stato del controllo per l'adattatore di controllo. (Ereditato da ControlAdapter) |
| SaveAdapterViewState() |
Salva le informazioni sullo stato di visualizzazione per l'adattatore di controllo. (Ereditato da ControlAdapter) |
| ToString() |
Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object) |
