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

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

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 Sie die HierarchicalDataBoundControlAdapter -Klasse erweitern, um ein hierarchisches Steuerelement zu rendern TreeView , das an ein XmlDataSource Objekt gebunden ist.

Dieses Codebeispiel enthält vier Objekte:

Ein von der -Klasse abgeleiteter HierarchicalDataBoundControlAdapter Adapter.
Die ASPX-Datei, die das Steuerelement und gerätespezifische TreeView 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

Im zweiten Codesegment wird veranschaulicht, wie ein TreeView deklariert wird, um eine Bindung an eine XML-Datenquelle zu binden.

<%@ 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 TreeView Steuerelement mit dem benutzerdefinierten Adapter für Browser verknüpft wird, die auf Windows CE ausgeführt werden.

Das letzte 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 -Klasse erweitern, um das HierarchicalDataBoundControlAdapter 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 es die Elemente in der Datenquelle aufzählt, an die es gebunden ist. Weitere Informationen zu hierarchischen datengebundenen Steuerelementen finden Sie unter HierarchicalDataBoundControl.

Steuerelementadapter are.NET Komponenten, die eine oder mehrere Phasen im Lebenszyklus eines Steuerelements für einen bestimmten Browser verwalten. Das Erweitern der HierarchicalDataBoundControlAdapter -Klasse ermöglicht den Zugriff auf die Lebenszyklusphasen des HierarchicalDataBoundControl Steuerelements. 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 angesichts 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

HierarchicalDataBoundControlAdapter()

Initialisiert eine neue Instanz der HierarchicalDataBoundControlAdapter-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 stark typisierten Verweis auf das HierarchicalDataBoundControl-Steuerelement ab, das 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

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)
PerformDataBinding()	Bindet die Daten in der Datenquelle des zugeordneten, hierarchischen datengebundenden 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 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: