HierarchicalDataBoundControlAdapter Klas

Definitie

Naamruimte:: System.Web.UI.WebControls.Adapters

Assembly:: System.Web.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Hiermee past u het gedrag aan van een HierarchicalDataBoundControl object waaraan deze besturingsadapter is gekoppeld, voor specifieke browseraanvragen.

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

Overname: Object

ControlAdapter

WebControlAdapter
HierarchicalDataBoundControlAdapter

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u de HierarchicalDataBoundControlAdapter klasse kunt uitbreiden om een hiërarchisch besturingselement TreeView weer te geven dat is gebonden aan een XmlDataSource object.

Dit codevoorbeeld bevat vier objecten:

Een adapter die is afgeleid van de HierarchicalDataBoundControlAdapter klasse.
Het .aspx-bestand dat de TreeView besturings- en apparaatspecifieke inhoud bevat.
Een browserbestand om de adapter aan een apparaattype te koppelen.
Een XML-bestand met een hiërarchische lijst met werknemers.

Dit codevoorbeeld bestaat uit vier codesegmenten. Het eerste codesegment laat zien hoe u de HierarchicalDataBoundControlAdapter klasse kunt uitbreiden.

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

Het tweede codesegment laat zien hoe u een TreeView binding kunt declareren met een XML-gegevensbron.

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

Het derde codesegment laat zien hoe u het besturingselement TreeView koppelt aan de aangepaste adapter voor browsers die worden uitgevoerd op Windows CE.

Het laatste codesegment bevat de XML-gegevens waarmee het TreeView besturingselement wordt verbonden.

Opmerkingen

De HierarchicalDataBoundControlAdapter klasse past het bijbehorende HierarchicalDataBoundControl besturingselement aan om de standaardmarkeringen of het standaardgedrag voor een specifieke browser te wijzigen. U kunt de HierarchicalDataBoundControlAdapter klasse uitbreiden om de weergave van het HierarchicalDataBoundControl besturingselement verder aan te passen.

Een HierarchicalDataBoundControl besturingselement is gebonden aan een gegevensbron en genereert de gebruikersinterface (of onderliggende besturingshiërarchie, meestal), door de items in de gegevensbron te inventariseren waaraan het is gebonden. Zie voor meer informatie over hiërarchische besturingselementen HierarchicalDataBoundControlvoor gegevens gebonden.

Besturingsadapters zijn.NET onderdelen die een of meer fasen in de levenscyclus van een besturingselement voor een specifieke browser beheren. Het uitbreiden van de HierarchicalDataBoundControlAdapter klasse biedt toegang tot de levenscyclusfasen van het HierarchicalDataBoundControl besturingselement. Zie Architectuuroverzicht van adaptief gedrag voor besturingselementen voor meer informatie.

De eerste aanvraag voor een adapter zorgt ervoor dat het .NET Framework zoekt naar een toegewezen adapter voor het besturingselement, gezien de kenmerken van de aanvragende browser. Browserdefinitiebestanden worden door de HttpBrowserCapabilities klasse gebruikt om de kenmerken van de clientbrowser te identificeren en de adapter toe te wijzen aan het browsertype.

Constructors

Name	Description
HierarchicalDataBoundControlAdapter()	Initialiseert een nieuw exemplaar van de HierarchicalDataBoundControlAdapter klasse.

Eigenschappen

Name	Description
Browser	Haalt een verwijzing op naar de browsermogelijkheden van de client die de huidige HTTP-aanvraag maakt. (Overgenomen van ControlAdapter)
Control	Hiermee wordt een sterk getypte verwijzing opgehaald naar het HierarchicalDataBoundControl besturingselement dat aan dit HierarchicalDataBoundControlAdapter object is gekoppeld.
IsEnabled	Hiermee wordt een waarde opgehaald die aangeeft of het webbesturingselement en alle bovenliggende besturingselementen zijn ingeschakeld. (Overgenomen van WebControlAdapter)
Page	Hiermee wordt een verwijzing naar de pagina opgehaald waar het besturingselement dat aan deze adapter is gekoppeld. (Overgenomen van ControlAdapter)
PageAdapter	Hiermee wordt een verwijzing naar de paginaadapter opgehaald voor de pagina waar het bijbehorende besturingselement zich bevindt. (Overgenomen van ControlAdapter)

Methoden

Name	Description
BeginRender(HtmlTextWriter)	Wordt aangeroepen vóór het weergeven van een besturingselement. In een afgeleide adapterklasse worden openingstags gegenereerd die vereist zijn voor een specifiek doel, maar niet nodig zijn voor HTML-browsers. (Overgenomen van ControlAdapter)
CreateChildControls()	Hiermee maakt u de doelspecifieke onderliggende besturingselementen voor een samengesteld besturingselement. (Overgenomen van ControlAdapter)
EndRender(HtmlTextWriter)	Aangeroepen na het weergeven van een besturingselement. In een afgeleide adapterklasse worden slottags gegenereerd die vereist zijn voor een specifiek doel, maar niet nodig zijn voor HTML-browsers. (Overgenomen van ControlAdapter)
Equals(Object)	Bepaalt of het opgegeven object gelijk is aan het huidige object. (Overgenomen van Object)
GetHashCode()	Fungeert als de standaardhashfunctie. (Overgenomen van Object)
GetType()	Hiermee haalt u de Type huidige instantie op. (Overgenomen van Object)
LoadAdapterControlState(Object)	Laadt informatie over de status van de adapter die tijdens een vorige aanvraag is opgeslagen SaveAdapterControlState() op de pagina waar het besturingselement dat aan deze besturingsadapter is gekoppeld. (Overgenomen van ControlAdapter)
LoadAdapterViewState(Object)	Laadt informatie over de weergavestatus van de adapter die is opgeslagen SaveAdapterViewState() tijdens een vorige aanvraag op de pagina waar het besturingselement dat aan deze besturingsadapter is gekoppeld, zich bevindt. (Overgenomen van ControlAdapter)
MemberwiseClone()	Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object)
OnInit(EventArgs)	Hiermee wordt de OnInit(EventArgs) methode voor het bijbehorende besturingselement overschreven. (Overgenomen van ControlAdapter)
OnLoad(EventArgs)	Hiermee wordt de OnLoad(EventArgs) methode voor het bijbehorende besturingselement overschreven. (Overgenomen van ControlAdapter)
OnPreRender(EventArgs)	Hiermee wordt de OnPreRender(EventArgs) methode voor het bijbehorende besturingselement overschreven. (Overgenomen van ControlAdapter)
OnUnload(EventArgs)	Hiermee wordt de OnUnload(EventArgs) methode voor het bijbehorende besturingselement overschreven. (Overgenomen van ControlAdapter)
PerformDataBinding()	Hiermee worden de gegevens in de gegevensbron van het gekoppelde hiërarchische besturingselement gekoppeld aan de adapter.
Render(HtmlTextWriter)	Hiermee genereert u de doelspecifieke markeringen voor het besturingselement waaraan de besturingsadapter is gekoppeld. (Overgenomen van WebControlAdapter)
RenderBeginTag(HtmlTextWriter)	Hiermee maakt u de begintag voor het web besturingselement in de markeringen die naar de doelbrowser worden verzonden. (Overgenomen van WebControlAdapter)
RenderChildren(HtmlTextWriter)	Hiermee genereert u de doelspecifieke opmaak voor de onderliggende besturingselementen in een samengesteld besturingselement waaraan de besturingsadapter is gekoppeld. (Overgenomen van ControlAdapter)
RenderContents(HtmlTextWriter)	Hiermee genereert u de doelspecifieke binnenmarkeringen voor het webbesturingselement waaraan de besturingsadapter is gekoppeld. (Overgenomen van WebControlAdapter)
RenderEndTag(HtmlTextWriter)	Hiermee maakt u de eindtag voor het webbesturingselement in de markeringen die naar de doelbrowser worden verzonden. (Overgenomen van WebControlAdapter)
SaveAdapterControlState()	Hiermee wordt informatie over de controlestatus voor de besturingsadapter opgeslagen. (Overgenomen van ControlAdapter)
SaveAdapterViewState()	Hiermee wordt informatie over de weergavestatus voor de besturingsadapter opgeslagen. (Overgenomen van ControlAdapter)
ToString()	Retourneert een tekenreeks die het huidige object vertegenwoordigt. (Overgenomen van Object)

Van toepassing op

Zie ook

Feedback

Is deze pagina nuttig?