HideDisabledControlAdapter Clase

Definición

Espacio de nombres:
System.Web.UI.WebControls.Adapters
Ensamblado:
System.Web.dll

Proporciona funcionalidades de representación para el control web asociado para modificar el marcado predeterminado o el comportamiento de un explorador específico.

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
Herencia
Object
ControlAdapter
WebControlAdapter
HideDisabledControlAdapter

Ejemplos

En el ejemplo de código siguiente se muestra cómo extender la HideDisabledControlAdapter clase para mostrar un Label control en un estado habilitado y deshabilitado. Este ejemplo contiene tres partes:

  • Un adaptador derivado de la HideDisabledControlAdapter clase .

  • El archivo .aspx que incorpora el control y el contenido específico del Label dispositivo.

  • Un archivo del explorador para vincular el adaptador a un tipo de dispositivo.

En el ejemplo de código siguiente se muestra cómo extender la HideDisabledControlAdapter clase .

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

En el ejemplo de código siguiente se muestra cómo declarar un Label control con contenido específico 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>

En el ejemplo de código siguiente se muestra cómo vincular el control /> de

Comentarios

La HideDisabledControlAdapter clase adapta el control asociado WebControl para modificar el marcado predeterminado o el comportamiento de un explorador específico. Puede ampliar la clase para personalizar aún más la HideDisabledControlAdapter representación del WebControl control.

Los adaptadores se compilan .NET componentes de Framework que ocupan una o varias fases en el ciclo de vida de una página o control. Extender la HideDisabledControlAdapter clase proporcionará acceso a las fases del ciclo de vida del WebControl control. Para obtener más información, consulte Introducción a la arquitectura del comportamiento del control adaptable.

La solicitud inicial de un adaptador hace que .NET Framework busque un adaptador asignado para el control dadas las características del explorador solicitante. La HttpBrowserCapabilities clase usa los archivos de definición del explorador para identificar las características del explorador cliente y asignar el adaptador al tipo de explorador. Para obtener más información, consulte Introducción a la arquitectura del comportamiento del control adaptable.

Constructores

Nombre Description
HideDisabledControlAdapter()

Inicializa una nueva instancia de la clase HideDisabledControlAdapter.

Propiedades

Nombre Description
Browser

Obtiene una referencia a las funcionalidades del explorador del cliente que realiza la solicitud HTTP actual.

(Heredado de ControlAdapter)
Control

Obtiene una referencia al control Web al que está asociado este adaptador de control.

(Heredado de WebControlAdapter)
IsEnabled

Obtiene un valor que indica si el control Web y todos sus controles primarios están habilitados.

(Heredado de WebControlAdapter)
Page

Obtiene una referencia a la página donde reside el control asociado a este adaptador.

(Heredado de ControlAdapter)
PageAdapter

Obtiene una referencia al adaptador de página de la página donde reside el control asociado.

(Heredado de ControlAdapter)

Métodos

Nombre Description
BeginRender(HtmlTextWriter)

Se llama antes de la representación de un control. En una clase de adaptador derivada, genera etiquetas de apertura necesarias para un destino específico, pero no necesarias para los exploradores HTML.

(Heredado de ControlAdapter)
CreateChildControls()

Crea los controles secundarios específicos del destino para un control compuesto.

(Heredado de ControlAdapter)
EndRender(HtmlTextWriter)

Se llama después de la representación de un control. En una clase de adaptador derivada, genera etiquetas de cierre necesarias para un destino específico, pero que no son necesarias para los exploradores HTML.

(Heredado de ControlAdapter)
Equals(Object)

Determina si el objeto especificado es igual al objeto actual.

(Heredado de Object)
GetHashCode()

Actúa como función hash predeterminada.

(Heredado de Object)
GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
LoadAdapterControlState(Object)

Carga la información de estado del control del adaptador que guardó SaveAdapterControlState() durante una solicitud anterior a la página donde reside el control asociado a este adaptador de control.

(Heredado de ControlAdapter)
LoadAdapterViewState(Object)

Carga la información de estado de vista del adaptador guardada por SaveAdapterViewState() durante una solicitud anterior a la página donde reside el control asociado a este adaptador de control.

(Heredado de ControlAdapter)
MemberwiseClone()

Crea una copia superficial del Objectactual.

(Heredado de Object)
OnInit(EventArgs)

Invalida el OnInit(EventArgs) método para el control asociado.

(Heredado de ControlAdapter)
OnLoad(EventArgs)

Invalida el OnLoad(EventArgs) método para el control asociado.

(Heredado de ControlAdapter)
OnPreRender(EventArgs)

Invalida el OnPreRender(EventArgs) método para el control asociado.

(Heredado de ControlAdapter)
OnUnload(EventArgs)

Invalida el OnUnload(EventArgs) método para el control asociado.

(Heredado de ControlAdapter)
Render(HtmlTextWriter)

Escribe el control web asociado en el flujo de salida como HTML.
RenderBeginTag(HtmlTextWriter)

Crea la etiqueta inicial para el control Web en el marcado que se transmite al explorador de destino.

(Heredado de WebControlAdapter)
RenderChildren(HtmlTextWriter)

Genera el marcado específico del destino para los controles secundarios en un control compuesto al que está asociado el adaptador de control.

(Heredado de ControlAdapter)
RenderContents(HtmlTextWriter)

Genera el marcado interno específico del destino para el control web al que está asociado el adaptador de control.

(Heredado de WebControlAdapter)
RenderEndTag(HtmlTextWriter)

Crea la etiqueta final para el control Web en el marcado que se transmite al explorador de destino.

(Heredado de WebControlAdapter)
SaveAdapterControlState()

Guarda la información de estado del control para el adaptador de control.

(Heredado de ControlAdapter)
SaveAdapterViewState()

Guarda la información de estado de vista del adaptador de control.

(Heredado de ControlAdapter)
ToString()

Devuelve una cadena que representa el objeto actual.

(Heredado de Object)

Se aplica a

Consulte también