HideDisabledControlAdapter Třída

Reference

Definice

Obor názvů:: System.Web.UI.WebControls.Adapters

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Poskytuje možnosti vykreslování přidruženého webového ovládacího prvku pro úpravu výchozích značek nebo chování pro konkrétní prohlížeč.

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

Dědičnost: Object

ControlAdapter

WebControlAdapter
HideDisabledControlAdapter

Příklady

Následující příklad kódu ukazuje, jak rozšířit HideDisabledControlAdapter třídu tak, aby zobrazila Label ovládací prvek v povoleném a zakázaném stavu. Tento příklad obsahuje tři části:

Adaptér odvozený z HideDisabledControlAdapter třídy.
Soubor .aspx, který obsahuje Label ovládací prvek a obsah specifický pro zařízení.
Soubor prohlížeče pro propojení adaptéru s typem zařízení.

Následující příklad kódu ukazuje, jak rozšířit HideDisabledControlAdapter třídu.

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

Následující příklad kódu ukazuje, jak deklarovat Label ovládací prvek s obsahem specifickým pro zařízení.

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

Následující příklad kódu ukazuje, jak propojit Label ovládací prvek s vlastním adaptérem pro prohlížeče spuštěné v systému Windows CE .NET.

Poznámky

Třída HideDisabledControlAdapter přizpůsobí přidružený WebControl ovládací prvek pro úpravu výchozího kódu nebo chování pro konkrétní prohlížeč. Třídu můžete rozšířit a HideDisabledControlAdapter dále přizpůsobit vykreslování WebControl ovládacího prvku.

Adaptéry jsou kompilované komponenty rozhraní .NET Framework, které přebírají jednu nebo více fází v životním cyklu stránky nebo ovládacího prvku. Rozšíření třídy HideDisabledControlAdapter poskytne přístup k fázím WebControl životního cyklu ovládacího prvku. Další informace najdete v tématu Přehled architektury chování adaptivního řízení.

Počáteční požadavek na adaptér způsobí, že rozhraní .NET Framework vyhledá mapovaný adaptér pro ovládací prvek vzhledem k charakteristikám žádajícího prohlížeče. Definiční soubory prohlížeče se používají HttpBrowserCapabilities ve třídě k identifikaci charakteristik klientského prohlížeče a mapování adaptéru na typ prohlížeče. Další informace najdete v tématu Přehled architektury chování adaptivního řízení.

Konstruktory

HideDisabledControlAdapter()

Inicializuje novou instanci HideDisabledControlAdapter třídy.

Vlastnosti

Browser	Získá odkaz na možnosti prohlížeče klienta, který provádí aktuální požadavek HTTP. (Zděděno od ControlAdapter)
Control	Získá odkaz na web ovládací prvek, ke kterému je připojen tento ovládací adaptér. (Zděděno od WebControlAdapter)
IsEnabled	Získá hodnotu označující, zda web ovládací prvek a všechny jeho nadřazené ovládací prvky jsou povoleny. (Zděděno od WebControlAdapter)
Page	Získá odkaz na stránku, kde se nachází ovládací prvek přidružený k tomuto adaptéru. (Zděděno od ControlAdapter)
PageAdapter	Získá odkaz na adaptér stránky pro stránku, kde se nachází přidružený ovládací prvek. (Zděděno od ControlAdapter)

Metody

BeginRender(HtmlTextWriter)	Volá se před vykreslením ovládacího prvku. V odvozené třídě adaptéru vygeneruje otevřené značky, které jsou požadovány konkrétním cílem, ale nejsou potřeba prohlížeči HTML. (Zděděno od ControlAdapter)
CreateChildControls()	Vytvoří podřízené ovládací prvky specifické pro cíl pro složený ovládací prvek. (Zděděno od ControlAdapter)
EndRender(HtmlTextWriter)	Volá se po vykreslení ovládacího prvku. V odvozené třídě adaptéru generuje uzavírací značky, které jsou požadovány konkrétním cílem, ale nejsou potřeba prohlížeči HTML. (Zděděno od ControlAdapter)
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetType()	Získá aktuální Type instanci. (Zděděno od Object)
LoadAdapterControlState(Object)	Načte informace o stavu ovládacího prvku adaptéru, které byly uloženy SaveAdapterControlState() během předchozího požadavku, na stránku, kde se nachází ovládací prvek přidružený k tomuto adaptéru ovládacího prvku. (Zděděno od ControlAdapter)
LoadAdapterViewState(Object)	Načte informace o stavu zobrazení adaptéru, které byly uloženy SaveAdapterViewState() během předchozího požadavku, na stránku, kde se nachází ovládací prvek přidružený k tomuto adaptéru ovládacího prvku. (Zděděno od ControlAdapter)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
OnInit(EventArgs)	Přepíše metodu OnInit(EventArgs) přidruženého ovládacího prvku. (Zděděno od ControlAdapter)
OnLoad(EventArgs)	Přepíše metodu OnLoad(EventArgs) přidruženého ovládacího prvku. (Zděděno od ControlAdapter)
OnPreRender(EventArgs)	Přepíše metodu OnPreRender(EventArgs) přidruženého ovládacího prvku. (Zděděno od ControlAdapter)
OnUnload(EventArgs)	Přepíše metodu OnUnload(EventArgs) přidruženého ovládacího prvku. (Zděděno od ControlAdapter)
Render(HtmlTextWriter)	Zapíše přidružený webový ovládací prvek do výstupního datového proudu jako HTML.
RenderBeginTag(HtmlTextWriter)	Vytvoří počáteční značku webového ovládacího prvku v kódu, který se přenáší do cílového prohlížeče. (Zděděno od WebControlAdapter)
RenderChildren(HtmlTextWriter)	Vygeneruje značky specifické pro cíl pro podřízené ovládací prvky ve složeném ovládacím prvku, ke kterému je připojen adaptér ovládacího prvku. (Zděděno od ControlAdapter)
RenderContents(HtmlTextWriter)	Vygeneruje vnitřní kód specifický pro cíl webového ovládacího prvku, ke kterému je připojen adaptér ovládacího prvku. (Zděděno od WebControlAdapter)
RenderEndTag(HtmlTextWriter)	Vytvoří koncovou značku webového ovládacího prvku ve značkách, které se přenesou do cílového prohlížeče. (Zděděno od WebControlAdapter)
SaveAdapterControlState()	Uloží informace o stavu ovládacího prvku pro adaptér ovládacího prvku. (Zděděno od ControlAdapter)
SaveAdapterViewState()	Uloží informace o stavu zobrazení pro adaptér ovládacího prvku. (Zděděno od ControlAdapter)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Platí pro

Sdílet prostřednictvím