HierarchicalDataBoundControlAdapter 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.

Passt das Verhalten eines HierarchicalDataBoundControl Objekts an, dem dieser Steuerelementadapter für bestimmte Browseranforderungen zugeordnet ist.

public ref class HierarchicalDataBoundControlAdapter : System::Web::UI::WebControls::Adapters::WebControlAdapter

public class HierarchicalDataBoundControlAdapter : System.Web.UI.WebControls.Adapters.WebControlAdapter

type HierarchicalDataBoundControlAdapter = class
    inherit WebControlAdapter

Public Class HierarchicalDataBoundControlAdapter
Inherits WebControlAdapter

Vererbung: Object

ControlAdapter

WebControlAdapter
HierarchicalDataBoundControlAdapter

Beispiele

Das folgende Codebeispiel zeigt, wie die HierarchicalDataBoundControlAdapter Klasse erweitert wird, um ein hierarchisches TreeView Steuerelement zu rendern, das an ein XmlDataSource Objekt gebunden ist.

Dieses Codebeispiel enthält vier Objekte:

Ein Adapter, der von der HierarchicalDataBoundControlAdapter Klasse abgeleitet ist.
Die .aspx Datei, die das TreeView Steuerelement und gerätespezifische Inhalte enthält.
Eine Browserdatei zum Verknüpfen des Adapters mit einem Gerätetyp.
Eine XML-Datei, die eine hierarchische Liste von Mitarbeitern enthält.

Dieses Codebeispiel besteht aus vier Codesegmenten. Das erste Codesegment veranschaulicht, wie die HierarchicalDataBoundControlAdapter 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 HierarchicalTreeViewAdapter :
        System.Web.UI.WebControls.Adapters.HierarchicalDataBoundControlAdapter
    {
        // Return a strongly-typed TreeView control for adapter.
        protected new System.Web.UI.WebControls.TreeView Control
        {
            get
            {
                return (System.Web.UI.WebControls.TreeView)base.Control;
            }
        }

        // Verify the DataSourceID property is set prior to binding data.
        protected override void PerformDataBinding()
        {
            if (Control.DataSourceID != null)
            {
                base.PerformDataBinding();
            }
        }
    }
}

Imports System.Web
Imports System.Security.Permissions

Namespace Contoso

    <AspNetHostingPermission(SecurityAction.Demand, _
        Level:=AspNetHostingPermissionLevel.Minimal)> _
    <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
        Level:=AspNetHostingPermissionLevel.Minimal)> _
    Public Class HierarchicalTreeViewAdapter
        Inherits _
        System.Web.UI.WebControls.Adapters.HierarchicalDataBoundControlAdapter

        ' Return a strongly-typed TreeView control for adapter.
        Protected Overloads ReadOnly Property Control() As _
            System.Web.UI.WebControls.TreeView

            Get
                Return CType( _
                    MyBase.Control, _
                    System.Web.UI.WebControls.TreeView)
            End Get
        End Property

        ' Verify the DataSourceID property is set prior to binding data.
        Protected Overrides Sub PerformDataBinding()

            If (Not Control.DataSourceID Is Nothing) Then

                MyBase.PerformDataBinding()
            End If
        End Sub
    End Class
End Namespace

Das zweite Codesegment veranschaulicht, wie eine TreeView Bindung an eine XML-Datenquelle 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 runat="server">
    <title>HierarchicalDataBoundControl Adapter</title>
</head>
<body>
    <form id="Form1" runat="server">
        <asp:TreeView ID="TreeView1" 
            Runat="server" 
            DataSourceID="XmlDataSource1">

            <DataBindings>
                <asp:TreeNodeBinding    
                    DataMember="employees" Text="Employees"/>
                <asp:TreeNodeBinding    
                    DataMember="employee" TextField="id" />
                <asp:TreeNodeBinding    
                    DataMember="name" TextField="fullname" />
            </DataBindings>
        </asp:TreeView>
        
        <asp:XmlDataSource ID="XmlDataSource1"  
            Runat="server" 
            DataFile="employees.xml" />
        <br />
    </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 runat="server">
    <title>HierarchicalDataBoundControl Adapter</title>
</head>
<body>
    <form id="Form1" runat="server">
        <asp:TreeView ID="TreeView1" 
            Runat="server" 
            DataSourceID="XmlDataSource1">

            <DataBindings>
                <asp:TreeNodeBinding    
                    DataMember="employees" Text="Employees"/>
                <asp:TreeNodeBinding    
                    DataMember="employee" TextField="id" />
                <asp:TreeNodeBinding    
                    DataMember="name" TextField="fullname" />
            </DataBindings>
        </asp:TreeView>
        
        <asp:XmlDataSource ID="XmlDataSource1"  
            Runat="server" 
            DataFile="employees.xml" />
        <br />
    </form>
</body>
</html>

Im dritten Codesegment wird gezeigt, wie das steuerelement TreeView mit dem benutzerdefinierten Adapter für Browser verknüpft wird, die auf Windows CE ausgeführt werden.

Das endgültige Codesegment stellt die XML-Daten bereit, an die das TreeView Steuerelement gebunden ist.

Hinweise

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

Ein HierarchicalDataBoundControl Steuerelement ist an eine Datenquelle gebunden und generiert seine Benutzeroberfläche (oder die untergeordnete Steuerelementhierarchie in der Regel), indem die Elemente in der Datenquelle aufgelistet werden, an die sie gebunden ist. Weitere Informationen zu hierarchischen datengebundenen Steuerelementen finden Sie unter HierarchicalDataBoundControl.

Steueradapter sind.NET Komponenten, die einen oder mehrere Phasen im Lebenszyklus eines Steuerelements für einen bestimmten Browser verwalten. Durch das Erweitern der HierarchicalDataBoundControlAdapter Klasse erhalten Sie Zugriff auf die Lebenszyklusphasen des HierarchicalDataBoundControl Steuerelements. Weitere Informationen finden Sie unter Architekturübersicht über adaptives Steuerelementverhalten.

Die anfängliche Anforderung für einen Adapter bewirkt, dass .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.

Konstruktoren

Name	Beschreibung
HierarchicalDataBoundControlAdapter()	Initialisiert eine neue Instanz der HierarchicalDataBoundControlAdapter-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 stark typierten Verweis auf das Steuerelement ab, das HierarchicalDataBoundControl diesem HierarchicalDataBoundControlAdapter Objekt zugeordnet ist.
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)
PerformDataBinding()	Bindet die Daten in der Datenquelle des zugeordneten hierarchischen datengebundenen Steuerelements an den Adapter.
Render(HtmlTextWriter)	Generiert das zielspezifische Markup für das Steuerelement, an das der Steuerelementadapter angefügt ist. (Geerbt von WebControlAdapter)
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?