HideDisabledControlAdapter 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.

Fornisce al controllo Web associato le funzionalità di rendering necessarie per modificare il markup o il comportamento predefinito di un browser specifico.

public ref class HideDisabledControlAdapter : System::Web::UI::WebControls::Adapters::WebControlAdapter

public class HideDisabledControlAdapter : System.Web.UI.WebControls.Adapters.WebControlAdapter

type HideDisabledControlAdapter = class
    inherit WebControlAdapter

Public Class HideDisabledControlAdapter
Inherits WebControlAdapter

Ereditarietà: Object

ControlAdapter

WebControlAdapter
HideDisabledControlAdapter

Esempio

Nell'esempio di codice seguente viene illustrato come estendere la HideDisabledControlAdapter classe per visualizzare un Label controllo in uno stato abilitato e disabilitato. Questo esempio contiene tre parti:

Una scheda derivata dalla HideDisabledControlAdapter classe .
Il file .aspx che incorpora il controllo e il contenuto specifico del Label dispositivo.
File del browser per collegare l'adattatore a un tipo di dispositivo.

Nell'esempio di codice seguente viene illustrato come estendere la HideDisabledControlAdapter classe.

using System;
using System.Web;
using System.Web.UI;
using System.Security.Permissions;

namespace Contoso
{
    [AspNetHostingPermission(
        SecurityAction.Demand, 
        Level = AspNetHostingPermissionLevel.Minimal)]
    [AspNetHostingPermission(
        SecurityAction.InheritanceDemand, 
        Level = AspNetHostingPermissionLevel.Minimal)]
    public class HideDisabledControlContosoAdapter:
        System.Web.UI.WebControls.Adapters.HideDisabledControlAdapter
    {
        // Link the Label control to the adapter.
        protected new System.Web.UI.WebControls.Label Control
        {
            get
            {
                return (System.Web.UI.WebControls.Label)base.Control;
            }
        }

        // Do not render the Contoso controls if Enabled is false.
        protected override void Render(System.Web.UI.HtmlTextWriter writer)
        {
            if (Control.ID.StartsWith("Contoso"))
            {
                if (!Control.Enabled)
                {
                    return;
                }
            }

            base.Render(writer);
        }
    }
}

Imports System.Web
Imports System.Web.UI
Imports System.Security.Permissions

Namespace Contoso
    <AspNetHostingPermission( _
        SecurityAction.Demand, _
        Level:=AspNetHostingPermissionLevel.Minimal)> _
    <AspNetHostingPermission( _
        SecurityAction.InheritanceDemand, _
        Level:=AspNetHostingPermissionLevel.Minimal)> _
    Public Class HideDisabledControlContosoAdapter
        Inherits System.Web.UI.WebControls.Adapters.HideDisabledControlAdapter
    
        Protected Overloads ReadOnly Property Control() As _
            System.Web.UI.WebControls.Label
            Get
                Return CType( _
                    MyBase.Control, _
                    System.Web.UI.WebControls.Label)
            End Get
        End Property

        ' Do not render the control if Enabled is false.
        Protected Overrides Sub Render(ByVal writer As HtmlTextWriter)
            If (Control.ID.StartsWith("Contoso")) Then
                If (Not Control.Enabled) Then
                    Return
                End If
            End If

            MyBase.Render(writer)
        End Sub
    End Class
End Namespace

Nell'esempio di codice seguente viene illustrato come dichiarare un Label controllo con contenuto specifico del dispositivo.

<%@ page language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>HideDisabledControl Adapter</title>
    <script runat="server">
        void ServerButtonClick(Object source, EventArgs args)
        {
            if (Button1.Text == "Enable Label")
            {
                ContosoLabel1.Enabled = true;
                Button1.Text = "Disable Label";
                messageLabel.Text = "The label is <b>En</b>abled";
            }
            else
            {
                ContosoLabel1.Enabled = false;
                Button1.Text = "Enable Label";
                messageLabel.Text = "The label is <b>dis</b>abled";
            }
        }
    </script>
</head>
<body style="background-color:silver">
    <form id="Form1" runat="server">
        <asp:Label id="ContosoLabel1"             
            text="Contoso Label" 
            WinCE:text="CE Label"
            BorderWidth="3" 
            BorderStyle="Inset"
            style="FONT-SIZE: xx-small"
            runat="server">
            </asp:Label>
        <br />
        <asp:Button id="Button1" 
            text="Disable Label"
            OnClick="ServerButtonClick" 
            runat="server" />
        <br />    
        <asp:Label id="messageLabel" 
            runat="server" 
            style="FONT-SIZE: xx-small"
            AssociatedControlID="Button1">
            <i>Select the button to disable the label.</i>
        </asp:Label>
    </form>
</body>
</html>

<%@ page language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>HideDisabledControl Adapter</title>
    <script runat="server">
        Sub ServerButtonClick(ByVal source As Object, ByVal args As EventArgs)
            If (Button1.Text.Equals("Enable Label")) Then
                ContosoLabel1.Enabled = True
                Button1.Text = "Disable Label"
                messageLabel.Text = "The label is <b>En</b>abled"
            Else
                ContosoLabel1.Enabled = False
                Button1.Text = "Enable Label"
                messageLabel.Text = "The label is <b>dis</b>abled"
            End If
        End Sub
    </script>
</head>
<body style="background-color:silver">
    <form id="Form1" runat="server">
        <asp:Label id="ContosoLabel1"             
            text="Contoso Label" 
            WinCE:text="CE Label"
            BorderWidth="3" 
            BorderStyle="Inset"
            style="FONT-SIZE: xx-small"
            runat="server">
            </asp:Label>
        <br />
        <asp:Button id="Button1" 
            text="Disable Label"
            OnClick="ServerButtonClick" 
            runat="server" />
        <br />    
        <asp:Label id="messageLabel" 
            runat="server" 
            style="FONT-SIZE: xx-small"
            AssociatedControlID="Button1">
            <i>Select the button to disable the label.</i>
        </asp:Label>
    </form>
</body>
</html>

Nell'esempio di codice seguente viene illustrato come collegare il Label controllo alla scheda personalizzata per i browser in esecuzione in Windows CE .NET.

Commenti

La HideDisabledControlAdapter classe adatta il controllo associato WebControl per modificare il markup o il comportamento predefinito per un browser specifico. È possibile estendere la classe per personalizzare ulteriormente il HideDisabledControlAdapter rendering del WebControl controllo.

Gli adapter sono componenti di .NET Framework compilati che accettano una o più fasi nel ciclo di vita di una pagina o di un controllo. L'estensione della HideDisabledControlAdapter classe fornirà l'accesso alle fasi del ciclo di vita del WebControl controllo. Per altre informazioni, vedere Panoramica dell'architettura del comportamento del controllo adattivo.

La richiesta iniziale per un adattatore causa la ricerca di un adattatore mappato per il controllo in base alle caratteristiche del browser di richiesta. I file di definizione del browser vengono usati dalla HttpBrowserCapabilities classe per identificare le caratteristiche del browser client e eseguire il mapping dell'adattatore al tipo di browser. Per altre informazioni, vedere Panoramica dell'architettura del comportamento del controllo adattivo.

Costruttori

HideDisabledControlAdapter()

Inizializza una nuova istanza della classe HideDisabledControlAdapter.

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. (Ereditato da WebControlAdapter)
IsEnabled	Ottiene un valore che indica se il controllo Web e tutti i relativi controlli padre sono abilitati. (Ereditato da WebControlAdapter)
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)	Scrive il controllo Web associato nel flusso di output come HTML.
RenderBeginTag(HtmlTextWriter)	Crea il tag di inizio per il controllo Web nel markup trasmesso al browser di destinazione. (Ereditato da WebControlAdapter)
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. (Ereditato da WebControlAdapter)
RenderEndTag(HtmlTextWriter)	Crea il tag di fine per il controllo Web nel markup trasmesso al browser di destinazione. (Ereditato da WebControlAdapter)
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

Condividi tramite