HideDisabledControlAdapter Classe

Référence

Définition

Espace de noms:: System.Web.UI.WebControls.Adapters

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Fournit des fonctionnalités de rendu permettant au contrôle Web associé de modifier le comportement ou le balisage par défaut d'un navigateur spécifique.

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

Héritage: Object

ControlAdapter

WebControlAdapter
HideDisabledControlAdapter

Exemples

L’exemple de code suivant montre comment étendre la HideDisabledControlAdapter classe pour afficher un Label contrôle dans un état activé et désactivé. Cet exemple contient trois parties :

Adaptateur dérivé de la HideDisabledControlAdapter classe .
Fichier .aspx qui incorpore le contrôle et le Label contenu propre à l’appareil.
Fichier de navigateur pour lier l’adaptateur à un type d’appareil.

L’exemple de code suivant montre comment étendre 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

L’exemple de code suivant montre comment déclarer un Label contrôle avec du contenu spécifique à l’appareil.

<%@ 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>

L’exemple de code suivant montre comment lier le Label contrôle à l’adaptateur personnalisé pour les navigateurs s’exécutant sur Windows CE .NET.

Remarques

La HideDisabledControlAdapter classe adapte le contrôle associé WebControl pour modifier le balisage ou le comportement par défaut d’un navigateur spécifique. Vous pouvez étendre la HideDisabledControlAdapter classe pour personnaliser davantage le rendu du WebControl contrôle.

Les adaptateurs sont des composants .NET Framework compilés qui prennent en charge une ou plusieurs étapes du cycle de vie d’une page ou d’un contrôle. L’extension de la HideDisabledControlAdapter classe permettra d’accéder aux étapes du cycle de vie du WebControl contrôle. Pour plus d’informations, consultez Vue d’ensemble de l’architecture du comportement du contrôle adaptatif.

La demande initiale d’un adaptateur amène le .NET Framework à rechercher un adaptateur mappé pour le contrôle en fonction des caractéristiques du navigateur demandeur. Les fichiers de définition de navigateur sont utilisés par la HttpBrowserCapabilities classe pour identifier les caractéristiques du navigateur client et mapper l’adaptateur au type de navigateur. Pour plus d’informations, consultez Vue d’ensemble de l’architecture du comportement du contrôle adaptatif.

Constructeurs

HideDisabledControlAdapter()

Initialise une nouvelle instance de la classe HideDisabledControlAdapter.

Propriétés

Browser	Reçoit une référence aux fonctionnalités de navigation du client effectuant la demande HTTP en cours. (Hérité de ControlAdapter)
Control	Obtient une référence au contrôle Web auquel cet adaptateur de contrôles est attaché. (Hérité de WebControlAdapter)
IsEnabled	Obtient une valeur indiquant si le contrôle Web et tous ses contrôles parents sont activés. (Hérité de WebControlAdapter)
Page	Reçoit une référence à la page sur laquelle réside le contrôle associé à cet adaptateur. (Hérité de ControlAdapter)
PageAdapter	Reçoit une référence à l'adaptateur de page pour la page sur laquelle réside le contrôle associé. (Hérité de ControlAdapter)

Méthodes

BeginRender(HtmlTextWriter)	Appelé avant le rendu d'un contrôle. Dans une classe d'adaptateur dérivée, génère des balises d'ouverture requises par une cible spécifique mais pas par les navigateurs HTML. (Hérité de ControlAdapter)
CreateChildControls()	Crée les contrôles enfants spécifiques à la cible pour un contrôle composite. (Hérité de ControlAdapter)
EndRender(HtmlTextWriter)	Appelé après le rendu d'un contrôle. Dans une classe d'adaptateur dérivée, génère des balises de fermeture requises par une cible spécifique mais pas par les navigateurs HTML. (Hérité de ControlAdapter)
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
LoadAdapterControlState(Object)	Charge des informations sur l'état du contrôle d'adaptateur qui ont été enregistrées par SaveAdapterControlState(), lors d'une demande antérieure, sur la page sur laquelle réside le contrôle associé à cet adaptateur de contrôles. (Hérité de ControlAdapter)
LoadAdapterViewState(Object)	Charge des informations sur l'état d'affichage de l'adaptateur qui ont été enregistrées par SaveAdapterViewState(), lors d'une demande antérieure, sur la page sur laquelle réside le contrôle associé à cet adaptateur de contrôles. (Hérité de ControlAdapter)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
OnInit(EventArgs)	Substitue la méthode OnInit(EventArgs) au contrôle associé. (Hérité de ControlAdapter)
OnLoad(EventArgs)	Substitue la méthode OnLoad(EventArgs) au contrôle associé. (Hérité de ControlAdapter)
OnPreRender(EventArgs)	Substitue la méthode OnPreRender(EventArgs) au contrôle associé. (Hérité de ControlAdapter)
OnUnload(EventArgs)	Substitue la méthode OnUnload(EventArgs) au contrôle associé. (Hérité de ControlAdapter)
Render(HtmlTextWriter)	Écrit le contrôle Web associé, au format HTML, dans le flux de sortie.
RenderBeginTag(HtmlTextWriter)	Crée la balise de début pour le contrôle Web dans le balisage transmis au navigateur cible. (Hérité de WebControlAdapter)
RenderChildren(HtmlTextWriter)	Génère la balise spécifique à la cible pour les contrôles enfants dans un contrôle composite auquel l'adaptateur de contrôles est joint. (Hérité de ControlAdapter)
RenderContents(HtmlTextWriter)	Génère le balisage interne spécifique à la cible pour le contrôle Web auquel l'adaptateur de contrôles est attaché. (Hérité de WebControlAdapter)
RenderEndTag(HtmlTextWriter)	Crée la balise de fin pour le contrôle Web dans le balisage transmis au navigateur cible. (Hérité de WebControlAdapter)
SaveAdapterControlState()	Enregistre les informations sur l'état de contrôle pour l'adaptateur de contrôles. (Hérité de ControlAdapter)
SaveAdapterViewState()	Enregistre les informations sur l'état d'affichage pour l'adaptateur de contrôles. (Hérité de ControlAdapter)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

S’applique à