HideDisabledControlAdapter Classe

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 pour le contrôle Web associé afin de modifier le balisage ou le comportement 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 contenu spécifique au contrôle et à l’appareil Label .
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 contrôle avec du contenu spécifique à l’appareil Label .

<%@ 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 contrôle Label à l’adaptateur personnalisé pour les navigateurs s’exécutant sur Windows .NET CE.

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 compilés .NET composants framework qui prennent plus d’une ou plusieurs étapes dans le cycle de vie d’une page ou d’un contrôle. L’extension de la HideDisabledControlAdapter classe fournira l’accès aux phases de cycle de vie du WebControl contrôle. Pour plus d’informations, consultez Vue d’ensemble architecturale du comportement du contrôle adaptatif.

La demande initiale d’un adaptateur entraîne la recherche d’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 architecturale du comportement du contrôle adaptatif.

Constructeurs

Nom	Description
HideDisabledControlAdapter()	Initialise une nouvelle instance de la classe HideDisabledControlAdapter.

Propriétés

Nom	Description
Browser	Obtient une référence aux fonctionnalités du navigateur du client qui effectuent la requête HTTP actuelle. (Hérité de ControlAdapter)
Control	Obtient une référence au contrôle Web auquel cet adaptateur de contrôle 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	Obtient une référence à la page où réside le contrôle associé à cet adaptateur. (Hérité de ControlAdapter)
PageAdapter	Obtient une référence à l’adaptateur de page de la page où réside le contrôle associé. (Hérité de ControlAdapter)

Méthodes

Nom	Description
BeginRender(HtmlTextWriter)	Appelé avant le rendu d’un contrôle. Dans une classe d’adaptateur dérivée, génère des balises ouvrantes requises par une cible spécifique, mais qui ne sont pas nécessaires 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 fermante requises par une cible spécifique, mais qui ne sont pas nécessaires 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()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
LoadAdapterControlState(Object)	Charge les informations d’état du contrôle de l’adaptateur enregistrées SaveAdapterControlState() lors d’une demande précédente sur la page où réside le contrôle associé à cet adaptateur de contrôle. (Hérité de ControlAdapter)
LoadAdapterViewState(Object)	Charge les informations d’état d’affichage de l’adaptateur enregistrées SaveAdapterViewState() lors d’une demande précédente sur la page où réside le contrôle associé à cet adaptateur de contrôle. (Hérité de ControlAdapter)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
OnInit(EventArgs)	Remplace la OnInit(EventArgs) méthode du contrôle associé. (Hérité de ControlAdapter)
OnLoad(EventArgs)	Remplace la OnLoad(EventArgs) méthode du contrôle associé. (Hérité de ControlAdapter)
OnPreRender(EventArgs)	Remplace la OnPreRender(EventArgs) méthode du contrôle associé. (Hérité de ControlAdapter)
OnUnload(EventArgs)	Remplace la OnUnload(EventArgs) méthode du contrôle associé. (Hérité de ControlAdapter)
Render(HtmlTextWriter)	Écrit le contrôle Web associé dans le flux de sortie en tant que code HTML.
RenderBeginTag(HtmlTextWriter)	Crée la balise de début du contrôle Web dans le balisage transmis au navigateur cible. (Hérité de WebControlAdapter)
RenderChildren(HtmlTextWriter)	Génère le balisage spécifique à la cible pour les contrôles enfants dans un contrôle composite auquel l’adaptateur de contrôle est attaché. (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ôle est attaché. (Hérité de WebControlAdapter)
RenderEndTag(HtmlTextWriter)	Crée la balise de fin du contrôle Web dans le balisage transmis au navigateur cible. (Hérité de WebControlAdapter)
SaveAdapterControlState()	Enregistre les informations d’état du contrôle pour l’adaptateur de contrôle. (Hérité de ControlAdapter)
SaveAdapterViewState()	Enregistre les informations d’état d’affichage de l’adaptateur de contrôle. (Hérité de ControlAdapter)
ToString()	Retourne une chaîne qui représente l’objet actuel. (Hérité de Object)

S’applique à

Voir aussi

Commentaires

Cette page a-t-elle été utile ?