HideDisabledControlAdapter Klasse

Definition

Namespace:: System.Web.UI.WebControls.Adapters

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Stellt Renderingfunktionen für das zugeordnete Websteuerelement bereit, um das Standardmarkup oder -verhalten für einen bestimmten Browser zu ändern.

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

Vererbung: Object

ControlAdapter

WebControlAdapter
HideDisabledControlAdapter

Beispiele

Das folgende Codebeispiel zeigt, wie Sie die HideDisabledControlAdapter Klasse erweitern, um ein Label Steuerelement in einem aktivierten und deaktivierten Zustand anzuzeigen. Dieses Beispiel enthält drei Teile:

Ein Adapter, der von der HideDisabledControlAdapter Klasse abgeleitet ist.
Die .aspx Datei, die das Label Steuerelement und gerätespezifische Inhalte enthält.
Eine Browserdatei zum Verknüpfen des Adapters mit einem Gerätetyp.

Im folgenden Codebeispiel wird veranschaulicht, wie die HideDisabledControlAdapter Klasse erweitert wird.

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

Im folgenden Codebeispiel wird veranschaulicht, wie ein Label Steuerelement mit gerätespezifischem Inhalt deklariert wird.

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

Im folgenden Codebeispiel wird gezeigt, wie das steuerelement Label mit dem benutzerdefinierten Adapter für Browser verknüpft wird, die auf Windows CE-.NET ausgeführt werden.

Hinweise

Die HideDisabledControlAdapter Klasse passt das zugeordnete WebControl Steuerelement an, um das Standardmarkup oder -verhalten für einen bestimmten Browser zu ändern. Sie können die HideDisabledControlAdapter Klasse erweitern, um das Rendering des WebControl Steuerelements weiter anzupassen.

Adapter werden .NET Framework-Komponenten kompiliert, die eine oder mehrere Phasen im Lebenszyklus einer Seite oder eines Steuerelements übernehmen. Durch das Erweitern der HideDisabledControlAdapter Klasse erhalten Sie Zugriff auf die Lebenszyklusphasen des WebControl Steuerelements. Weitere Informationen finden Sie unter Architekturübersicht über adaptives Steuerelementverhalten.

Die anfängliche Anforderung für einen Adapter bewirkt, dass .NET Framework nach einem zugeordneten Adapter für das Steuerelement sucht, das die Merkmale des anfordernden Browsers aufweist. Browserdefinitionsdateien werden von der HttpBrowserCapabilities Klasse verwendet, um die Merkmale des Clientbrowsers zu identifizieren und den Adapter dem Browsertyp zuzuordnen. Weitere Informationen finden Sie unter Architekturübersicht über adaptives Steuerelementverhalten.

Konstruktoren

Name	Beschreibung
HideDisabledControlAdapter()	Initialisiert eine neue Instanz der HideDisabledControlAdapter-Klasse.

Eigenschaften

Name	Beschreibung
Browser	Ruft einen Verweis auf die Browserfunktionen des Clients ab, die die aktuelle HTTP-Anforderung ausführen. (Geerbt von ControlAdapter)
Control	Ruft einen Verweis auf das Websteuerelement ab, an das dieser Steuerelementadapter angefügt ist. (Geerbt von WebControlAdapter)
IsEnabled	Ruft einen Wert ab, der angibt, ob das Websteuerelement und alle übergeordneten Steuerelemente aktiviert sind. (Geerbt von WebControlAdapter)
Page	Ruft einen Verweis auf die Seite ab, auf der sich das diesem Adapter zugeordnete Steuerelement befindet. (Geerbt von ControlAdapter)
PageAdapter	Ruft einen Verweis auf den Seitenadapter für die Seite ab, auf der sich das zugeordnete Steuerelement befindet. (Geerbt von ControlAdapter)

Methoden

Name	Beschreibung
BeginRender(HtmlTextWriter)	Wird vor dem Rendern eines Steuerelements aufgerufen. Generiert in einer abgeleiteten Adapterklasse öffnende Tags, die für ein bestimmtes Ziel erforderlich sind, aber nicht von HTML-Browsern benötigt werden. (Geerbt von ControlAdapter)
CreateChildControls()	Erstellt die zielspezifischen untergeordneten Steuerelemente für ein zusammengesetztes Steuerelement. (Geerbt von ControlAdapter)
EndRender(HtmlTextWriter)	Wird nach dem Rendern eines Steuerelements aufgerufen. Generiert in einer abgeleiteten Adapterklasse schließende Tags, die von einem bestimmten Ziel erforderlich sind, aber nicht von HTML-Browsern benötigt werden. (Geerbt von ControlAdapter)
Equals(Object)	Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object)
GetHashCode()	Dient als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
LoadAdapterControlState(Object)	Lädt die Statusinformationen des Adaptersteuerelements, die während einer vorherigen Anforderung an die Seite gespeichert SaveAdapterControlState() wurden, auf der sich das Steuerelement befindet, das diesem Steuerelementadapter zugeordnet ist. (Geerbt von ControlAdapter)
LoadAdapterViewState(Object)	Lädt die Statusinformationen der Adapteransicht, die während einer vorherigen Anforderung an die Seite gespeichert SaveAdapterViewState() wurden, auf der sich das steuerelement, das diesem Steuerelementadapter zugeordnet ist, befindet. (Geerbt von ControlAdapter)
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
OnInit(EventArgs)	Überschreibt die OnInit(EventArgs) Methode für das zugeordnete Steuerelement. (Geerbt von ControlAdapter)
OnLoad(EventArgs)	Überschreibt die OnLoad(EventArgs) Methode für das zugeordnete Steuerelement. (Geerbt von ControlAdapter)
OnPreRender(EventArgs)	Überschreibt die OnPreRender(EventArgs) Methode für das zugeordnete Steuerelement. (Geerbt von ControlAdapter)
OnUnload(EventArgs)	Überschreibt die OnUnload(EventArgs) Methode für das zugeordnete Steuerelement. (Geerbt von ControlAdapter)
Render(HtmlTextWriter)	Schreibt das zugeordnete Websteuerelement als HTML in den Ausgabedatenstrom.
RenderBeginTag(HtmlTextWriter)	Erstellt das Starttag für das Websteuerelement im Markup, das an den Zielbrowser übertragen wird. (Geerbt von WebControlAdapter)
RenderChildren(HtmlTextWriter)	Generiert das zielspezifische Markup für die untergeordneten Steuerelemente in einem zusammengesetzten Steuerelement, an das der Steuerelementadapter angefügt ist. (Geerbt von ControlAdapter)
RenderContents(HtmlTextWriter)	Generiert das zielspezifische innere Markup für das Websteuerelement, an das der Steuerelementadapter angefügt ist. (Geerbt von WebControlAdapter)
RenderEndTag(HtmlTextWriter)	Erstellt das Endtag für das Websteuerelement im Markup, das an den Zielbrowser übertragen wird. (Geerbt von WebControlAdapter)
SaveAdapterControlState()	Speichert Steuerstatusinformationen für den Steuerelementadapter. (Geerbt von ControlAdapter)
SaveAdapterViewState()	Speichert Ansichtsstatusinformationen für den Steuerelementadapter. (Geerbt von ControlAdapter)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Gilt für:

Weitere Informationen

Feedback

War diese Seite hilfreich?