HideDisabledControlAdapter Klas

Definitie

Naamruimte:
System.Web.UI.WebControls.Adapters
Assembly:
System.Web.dll

Biedt renderingmogelijkheden voor het bijbehorende webbesturing om de standaardmarkeringen of het standaardgedrag voor een specifieke browser te wijzigen.

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

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u de HideDisabledControlAdapter klasse kunt uitbreiden om een Label besturingselement weer te geven met de status Ingeschakeld en Uitgeschakeld. Dit voorbeeld bevat drie onderdelen:

  • Een adapter die is afgeleid van de HideDisabledControlAdapter klasse.

  • Het .aspx-bestand dat de Label besturings- en apparaatspecifieke inhoud bevat.

  • Een browserbestand om de adapter aan een apparaattype te koppelen.

In het volgende codevoorbeeld ziet u hoe u de HideDisabledControlAdapter klasse kunt uitbreiden.

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

In het volgende codevoorbeeld ziet u hoe u een Label besturingselement declareert met apparaatspecifieke inhoud.

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

In het volgende codevoorbeeld ziet u hoe u het besturingselement Label koppelt aan de aangepaste adapter voor browsers die worden uitgevoerd op Windows CE-.NET.

Opmerkingen

De HideDisabledControlAdapter klasse past het bijbehorende WebControl besturingselement aan om de standaardmarkeringen of het standaardgedrag voor een specifieke browser te wijzigen. U kunt de HideDisabledControlAdapter klasse uitbreiden om de weergave van het WebControl besturingselement verder aan te passen.

Adapters worden gecompileerd .NET Framework-onderdelen die een of meer fasen in de levenscyclus van een pagina of besturingselement overnemen. Als u de HideDisabledControlAdapter klasse uitbreidt, krijgt u toegang tot de levenscyclusfasen van het WebControl besturingselement. Zie Architectuuroverzicht van adaptief gedrag voor besturingselementen voor meer informatie.

De eerste aanvraag voor een adapter zorgt ervoor dat het .NET Framework zoekt naar een toegewezen adapter voor het besturingselement op basis van de kenmerken van de aanvragende browser. Browserdefinitiebestanden worden door de HttpBrowserCapabilities klasse gebruikt om de kenmerken van de clientbrowser te identificeren en de adapter toe te wijzen aan het browsertype. Zie Architectuuroverzicht van adaptief gedrag voor besturingselementen voor meer informatie.

Constructors

Name Description
HideDisabledControlAdapter()

Initialiseert een nieuw exemplaar van de HideDisabledControlAdapter klasse.

Eigenschappen

Name Description
Browser

Haalt een verwijzing op naar de browsermogelijkheden van de client die de huidige HTTP-aanvraag maakt.

(Overgenomen van ControlAdapter)
Control

Hiermee haalt u een verwijzing op naar het webbesturing waaraan deze besturingsadapter is gekoppeld.

(Overgenomen van WebControlAdapter)
IsEnabled

Hiermee wordt een waarde opgehaald die aangeeft of het webbesturingselement en alle bovenliggende besturingselementen zijn ingeschakeld.

(Overgenomen van WebControlAdapter)
Page

Hiermee wordt een verwijzing naar de pagina opgehaald waar het besturingselement dat aan deze adapter is gekoppeld.

(Overgenomen van ControlAdapter)
PageAdapter

Hiermee wordt een verwijzing naar de paginaadapter opgehaald voor de pagina waar het bijbehorende besturingselement zich bevindt.

(Overgenomen van ControlAdapter)

Methoden

Name Description
BeginRender(HtmlTextWriter)

Wordt aangeroepen vóór het weergeven van een besturingselement. In een afgeleide adapterklasse worden openingstags gegenereerd die vereist zijn voor een specifiek doel, maar niet nodig zijn voor HTML-browsers.

(Overgenomen van ControlAdapter)
CreateChildControls()

Hiermee maakt u de doelspecifieke onderliggende besturingselementen voor een samengesteld besturingselement.

(Overgenomen van ControlAdapter)
EndRender(HtmlTextWriter)

Aangeroepen na het weergeven van een besturingselement. In een afgeleide adapterklasse worden slottags gegenereerd die vereist zijn voor een specifiek doel, maar niet nodig zijn voor HTML-browsers.

(Overgenomen van ControlAdapter)
Equals(Object)

Bepaalt of het opgegeven object gelijk is aan het huidige object.

(Overgenomen van Object)
GetHashCode()

Fungeert als de standaardhashfunctie.

(Overgenomen van Object)
GetType()

Hiermee haalt u de Type huidige instantie op.

(Overgenomen van Object)
LoadAdapterControlState(Object)

Laadt informatie over de status van de adapter die tijdens een vorige aanvraag is opgeslagen SaveAdapterControlState() op de pagina waar het besturingselement dat aan deze besturingsadapter is gekoppeld.

(Overgenomen van ControlAdapter)
LoadAdapterViewState(Object)

Laadt informatie over de weergavestatus van de adapter die is opgeslagen SaveAdapterViewState() tijdens een vorige aanvraag op de pagina waar het besturingselement dat aan deze besturingsadapter is gekoppeld, zich bevindt.

(Overgenomen van ControlAdapter)
MemberwiseClone()

Hiermee maakt u een ondiepe kopie van de huidige Object.

(Overgenomen van Object)
OnInit(EventArgs)

Hiermee wordt de OnInit(EventArgs) methode voor het bijbehorende besturingselement overschreven.

(Overgenomen van ControlAdapter)
OnLoad(EventArgs)

Hiermee wordt de OnLoad(EventArgs) methode voor het bijbehorende besturingselement overschreven.

(Overgenomen van ControlAdapter)
OnPreRender(EventArgs)

Hiermee wordt de OnPreRender(EventArgs) methode voor het bijbehorende besturingselement overschreven.

(Overgenomen van ControlAdapter)
OnUnload(EventArgs)

Hiermee wordt de OnUnload(EventArgs) methode voor het bijbehorende besturingselement overschreven.

(Overgenomen van ControlAdapter)
Render(HtmlTextWriter)

Hiermee schrijft u het bijbehorende webbeheer naar de uitvoerstroom als HTML.
RenderBeginTag(HtmlTextWriter)

Hiermee maakt u de begintag voor het web besturingselement in de markeringen die naar de doelbrowser worden verzonden.

(Overgenomen van WebControlAdapter)
RenderChildren(HtmlTextWriter)

Hiermee genereert u de doelspecifieke opmaak voor de onderliggende besturingselementen in een samengesteld besturingselement waaraan de besturingsadapter is gekoppeld.

(Overgenomen van ControlAdapter)
RenderContents(HtmlTextWriter)

Hiermee genereert u de doelspecifieke binnenmarkeringen voor het webbesturingselement waaraan de besturingsadapter is gekoppeld.

(Overgenomen van WebControlAdapter)
RenderEndTag(HtmlTextWriter)

Hiermee maakt u de eindtag voor het webbesturingselement in de markeringen die naar de doelbrowser worden verzonden.

(Overgenomen van WebControlAdapter)
SaveAdapterControlState()

Hiermee wordt informatie over de controlestatus voor de besturingsadapter opgeslagen.

(Overgenomen van ControlAdapter)
SaveAdapterViewState()

Hiermee wordt informatie over de weergavestatus voor de besturingsadapter opgeslagen.

(Overgenomen van ControlAdapter)
ToString()

Retourneert een tekenreeks die het huidige object vertegenwoordigt.

(Overgenomen van Object)

Van toepassing op

Zie ook