HideDisabledControlAdapter Klass

Definition

Namnområde:: System.Web.UI.WebControls.Adapters

Sammansättning:: System.Web.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Tillhandahåller återgivningsfunktioner för den associerade webbkontrollen för att ändra standardmarkeringen eller beteendet för en viss webbläsare.

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

Arv: Object

ControlAdapter

WebControlAdapter
HideDisabledControlAdapter

Exempel

I följande kodexempel visas hur du utökar HideDisabledControlAdapter klassen för att visa en Label kontroll i ett aktiverat och inaktiverat tillstånd. Det här exemplet innehåller tre delar:

Ett kort som härletts HideDisabledControlAdapter från klassen.
Den .aspx fil som innehåller Label kontroll- och enhetsspecifikt innehåll.
En webbläsarfil som länkar adaptern till en enhetstyp.

Följande kodexempel visar hur du HideDisabledControlAdapter utökar klassen.

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

I följande kodexempel visas hur du deklarerar en Label kontroll med enhetsspecifikt innehåll.

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

I följande kodexempel visas hur du länkar kontrollen Label till det anpassade adaptern för webbläsare som körs på Windows CE-.NET.

Kommentarer

Klassen HideDisabledControlAdapter anpassar den associerade WebControl kontrollen för att ändra standardmarkeringen eller beteendet för en specifik webbläsare. Du kan utöka HideDisabledControlAdapter klassen för att ytterligare anpassa återgivningen WebControl av kontrollen.

Kort kompileras .NET Framework-komponenter som tar över en eller flera steg i livscykeln för en sida eller kontroll. Om du utökar HideDisabledControlAdapter klassen får du åtkomst till livscykelstegen i WebControl kontrollen. Mer information finns i Arkitekturöversikt över beteende för anpassningsbar kontroll.

Den första begäran om ett kort gör att .NET Framework söker efter ett mappat kort efter kontrollen med tanke på egenskaperna för den begärande webbläsaren. Webbläsardefinitionsfiler används av HttpBrowserCapabilities klassen för att identifiera egenskaperna för klientwebbläsaren och mappa kortet till webbläsartypen. Mer information finns i Arkitekturöversikt över beteende för anpassningsbar kontroll.

Konstruktorer

Name	Description
HideDisabledControlAdapter()	Initierar en ny instans av HideDisabledControlAdapter klassen.

Egenskaper

Name	Description
Browser	Hämtar en referens till webbläsarfunktionerna för klienten som gör den aktuella HTTP-begäran. (Ärvd från ControlAdapter)
Control	Hämtar en referens till webbkontrollen som det här kontrollkortet är anslutet till. (Ärvd från WebControlAdapter)
IsEnabled	Hämtar ett värde som anger om webbkontrollen och alla dess överordnade kontroller är aktiverade. (Ärvd från WebControlAdapter)
Page	Hämtar en referens till sidan där kontrollen som är associerad med det här kortet finns. (Ärvd från ControlAdapter)
PageAdapter	Hämtar en referens till sidkortet för sidan där den associerade kontrollen finns. (Ärvd från ControlAdapter)

Metoder

Name	Description
BeginRender(HtmlTextWriter)	Anropas innan en kontroll återges. I en härledd adapterklass genererar du öppningstaggar som krävs av ett specifikt mål men som inte behövs av HTML-webbläsare. (Ärvd från ControlAdapter)
CreateChildControls()	Skapar målspecifika underordnade kontroller för en sammansatt kontroll. (Ärvd från ControlAdapter)
EndRender(HtmlTextWriter)	Anropas efter återgivningen av en kontroll. I en härledd adapterklass genererar du avslutande taggar som krävs av ett specifikt mål men som inte behövs av HTML-webbläsare. (Ärvd från ControlAdapter)
Equals(Object)	Avgör om det angivna objektet är lika med det aktuella objektet. (Ärvd från Object)
GetHashCode()	Fungerar som standard-hash-funktion. (Ärvd från Object)
GetType()	Hämtar den aktuella instansen Type . (Ärvd från Object)
LoadAdapterControlState(Object)	Läser in information om kortkontrolltillstånd som sparades av SaveAdapterControlState() under en tidigare begäran till sidan där kontrollen som är associerad med det här kontrollkortet finns. (Ärvd från ControlAdapter)
LoadAdapterViewState(Object)	Läser in tillståndsinformation för adaptervy som sparades av SaveAdapterViewState() under en tidigare begäran till sidan där kontrollen som är associerad med det här kontrollkortet finns. (Ärvd från ControlAdapter)
MemberwiseClone()	Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object)
OnInit(EventArgs)	Åsidosätter OnInit(EventArgs) metoden för den associerade kontrollen. (Ärvd från ControlAdapter)
OnLoad(EventArgs)	Åsidosätter OnLoad(EventArgs) metoden för den associerade kontrollen. (Ärvd från ControlAdapter)
OnPreRender(EventArgs)	Åsidosätter OnPreRender(EventArgs) metoden för den associerade kontrollen. (Ärvd från ControlAdapter)
OnUnload(EventArgs)	Åsidosätter OnUnload(EventArgs) metoden för den associerade kontrollen. (Ärvd från ControlAdapter)
Render(HtmlTextWriter)	Skriver den associerade webbkontrollen till utdataströmmen som HTML.
RenderBeginTag(HtmlTextWriter)	Skapar starttaggen för webbkontrollen i markeringen som skickas till målwebbläsaren. (Ärvd från WebControlAdapter)
RenderChildren(HtmlTextWriter)	Genererar den målspecifika markering för de underordnade kontrollerna i en sammansatt kontroll som kontrollkortet är anslutet till. (Ärvd från ControlAdapter)
RenderContents(HtmlTextWriter)	Genererar den målspecifika inre markeringen för webbkontrollen som kontrollkortet är anslutet till. (Ärvd från WebControlAdapter)
RenderEndTag(HtmlTextWriter)	Skapar sluttaggen för webbkontrollen i markeringen som överförs till målwebbläsaren. (Ärvd från WebControlAdapter)
SaveAdapterControlState()	Sparar kontrolltillståndsinformation för kontrollkortet. (Ärvd från ControlAdapter)
SaveAdapterViewState()	Sparar visa tillståndsinformation för kontrollkortet. (Ärvd från ControlAdapter)
ToString()	Returnerar en sträng som representerar det aktuella objektet. (Ärvd från Object)

Gäller för

Se även

Feedback

Var den här sidan till hjälp?