HideDisabledControlAdapter Klasse

Referenz

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 Renderfunktionen für das zugeordnete Websteuerelement bereit, um das Standardmarkup oder Standardverhalten eines bestimmten Browsers 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

Im folgenden Codebeispiel wird gezeigt, wie Sie die HideDisabledControlAdapter -Klasse erweitern, um ein Label Steuerelement in einem aktivierten und deaktivierten Zustand anzuzeigen. Dieses Beispiel enthält drei Teile:

Ein von der -Klasse abgeleiteter HideDisabledControlAdapter Adapter.
Die ASPX-Datei, die das Steuerelement und den Label gerätespezifischen Inhalt enthält.
Eine Browserdatei zum Verknüpfen des Adapters mit einem Gerätetyp.

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

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 sie ein Label Steuerelement mit gerätespezifischem Inhalt deklarieren.

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

Das folgende Codebeispiel zeigt, wie Das Steuerelement mit dem Label benutzerdefinierten Adapter für Browser verknüpft wird, die unter 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 -Klasse erweitern, um das HideDisabledControlAdapter 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. Wenn Sie die HideDisabledControlAdapter -Klasse erweitern, erhalten Sie Zugriff auf die Lebenszyklusphasen des Steuerelements WebControl . Weitere Informationen finden Sie unter Architekturübersicht über das Verhalten adaptiver Steuerungen.

Die anfängliche Anforderung für einen Adapter bewirkt, dass der .NET Framework unter Berücksichtigung der Merkmale des anfordernden Browsers nach einem zugeordneten Adapter für das Steuerelement sucht. 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 das Verhalten adaptiver Steuerungen.

Konstruktoren

HideDisabledControlAdapter()

Initialisiert eine neue Instanz der HideDisabledControlAdapter-Klasse.

Eigenschaften

Browser	Ruft einen Verweis auf die Browserfunktionen des Clients ab, durch den die aktuelle HTTP-Anforderung erfolgt. (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

BeginRender(HtmlTextWriter)	Wird vor dem Rendering eines Steuerelements aufgerufen. Generiert in einer abgeleiteten Adapterklasse öffnende Tags, die für ein bestimmtes Ziel erforderlich sind, von HTML-Browsern jedoch nicht 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 Rendering eines Steuerelements aufgerufen. Generiert in einer abgeleiteten Adapterklasse schließende Tags, die für ein bestimmtes Ziel erforderlich sind, von HTML-Browsern jedoch nicht benötigt werden. (Geerbt von ControlAdapter)
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
LoadAdapterControlState(Object)	Lädt Steuerelementzustandsinformationen des Adapters, die von SaveAdapterControlState() während einer vorherigen Anforderung der Seite, auf der sich das diesem Steuerelementadapter zugeordnete Steuerelement befindet, gespeichert wurden. (Geerbt von ControlAdapter)
LoadAdapterViewState(Object)	Lädt Ansichtszustandsinformationen des Adapters, die von SaveAdapterViewState() während einer vorherigen Anforderung der Seite, auf der sich das diesem Steuerelementadapter zugeordnete Steuerelement befindet, gespeichert wurden. (Geerbt von ControlAdapter)
MemberwiseClone()	Erstellt eine flache Kopie des 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-Code in den Ausgabestream.
RenderBeginTag(HtmlTextWriter)	Erstellt das Anfangstag 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 wird. (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 Steuerelementzustandsinformationen für den Steuerelementadapter. (Geerbt von ControlAdapter)
SaveAdapterViewState()	Speichert Ansichtszustandsinformationen für den Steuerelementadapter. (Geerbt von ControlAdapter)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Gilt für:

Share via