HierarchicalDataBoundControlAdapter Klass

Definition

Namnområde:: System.Web.UI.WebControls.Adapters

Sammansättning:: System.Web.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Anpassar beteendet för ett HierarchicalDataBoundControl objekt som det här kontrollkortet är associerat med för specifika webbläsarbegäranden.

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

Arv: Object

ControlAdapter

WebControlAdapter
HierarchicalDataBoundControlAdapter

Exempel

I följande kodexempel visas hur du utökar HierarchicalDataBoundControlAdapter klassen för att återge en hierarkisk TreeView kontroll som är bunden till ett XmlDataSource objekt.

Det här kodexemplet innehåller fyra objekt:

Ett kort som härletts HierarchicalDataBoundControlAdapter från klassen.
Den .aspx fil som innehåller TreeView kontroll- och enhetsspecifikt innehåll.
En webbläsarfil som länkar adaptern till en enhetstyp.
En XML-fil som innehåller en hierarkisk lista över anställda.

Det här kodexemplet består av fyra kodsegment. Det första kodsegmentet visar hur du HierarchicalDataBoundControlAdapter utökar klassen.

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

Det andra kodsegmentet visar hur du deklarerar en TreeView bindning till en XML-datakälla.

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

Det tredje kodsegmentet visar hur du länkar kontrollen TreeView till det anpassade adaptern för webbläsare som körs på Windows CE.

Det sista kodsegmentet innehåller DE XML-data som TreeView kontrollen binder till.

Kommentarer

Klassen HierarchicalDataBoundControlAdapter anpassar den associerade HierarchicalDataBoundControl kontrollen för att ändra standardmarkeringen eller beteendet för en specifik webbläsare. Du kan utöka HierarchicalDataBoundControlAdapter klassen för att ytterligare anpassa återgivningen HierarchicalDataBoundControl av kontrollen.

En HierarchicalDataBoundControl kontroll är bunden till en datakälla och genererar dess användargränssnitt (eller underordnad kontrollhierarki, vanligtvis) genom att räkna upp objekten i datakällan som den är bunden till. Mer information om hierarkiska databundna kontroller finns i HierarchicalDataBoundControl.

Kontrollkort är.NET komponenter som hanterar en eller flera steg i livscykeln för en kontroll för en specifik webbläsare. Om du utökar HierarchicalDataBoundControlAdapter klassen får du åtkomst till livscykelstegen för HierarchicalDataBoundControl kontrollen. Mer information finns i Arkitekturöversikt över beteende för anpassningsbar kontroll.

Den första begäran om ett kort gör att .NET Framework söker efter ett mappat kort för kontrollen, med tanke på egenskaperna hos den begärande webbläsaren. Webbläsardefinitionsfiler används av HttpBrowserCapabilities klassen för att identifiera egenskaperna för klientwebbläsaren och mappa kortet till webbläsartypen.

Konstruktorer

Name	Description
HierarchicalDataBoundControlAdapter()	Initierar en ny instans av HierarchicalDataBoundControlAdapter klassen.

Egenskaper

Name	Description
Browser	Hämtar en referens till webbläsarfunktionerna för klienten som gör den aktuella HTTP-begäran. (Ärvd från ControlAdapter)
Control	Hämtar en starkt skriven referens till kontrollen HierarchicalDataBoundControl som är associerad med det här HierarchicalDataBoundControlAdapter objektet.
IsEnabled	Hämtar ett värde som anger om webbkontrollen och alla dess överordnade kontroller är aktiverade. (Ärvd från WebControlAdapter)
Page	Hämtar en referens till sidan där kontrollen som är associerad med det här kortet finns. (Ärvd från ControlAdapter)
PageAdapter	Hämtar en referens till sidkortet för sidan där den associerade kontrollen finns. (Ärvd från ControlAdapter)

Metoder

Name	Description
BeginRender(HtmlTextWriter)	Anropas innan en kontroll återges. I en härledd adapterklass genererar du öppningstaggar som krävs av ett specifikt mål men som inte behövs av HTML-webbläsare. (Ärvd från ControlAdapter)
CreateChildControls()	Skapar målspecifika underordnade kontroller för en sammansatt kontroll. (Ärvd från ControlAdapter)
EndRender(HtmlTextWriter)	Anropas efter återgivningen av en kontroll. I en härledd adapterklass genererar du avslutande taggar som krävs av ett specifikt mål men som inte behövs av HTML-webbläsare. (Ärvd från ControlAdapter)
Equals(Object)	Avgör om det angivna objektet är lika med det aktuella objektet. (Ärvd från Object)
GetHashCode()	Fungerar som standard-hash-funktion. (Ärvd från Object)
GetType()	Hämtar den aktuella instansen Type . (Ärvd från Object)
LoadAdapterControlState(Object)	Läser in information om kortkontrolltillstånd som sparades av SaveAdapterControlState() under en tidigare begäran till sidan där kontrollen som är associerad med det här kontrollkortet finns. (Ärvd från ControlAdapter)
LoadAdapterViewState(Object)	Läser in tillståndsinformation för adaptervy som sparades av SaveAdapterViewState() under en tidigare begäran till sidan där kontrollen som är associerad med det här kontrollkortet finns. (Ärvd från ControlAdapter)
MemberwiseClone()	Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object)
OnInit(EventArgs)	Åsidosätter OnInit(EventArgs) metoden för den associerade kontrollen. (Ärvd från ControlAdapter)
OnLoad(EventArgs)	Åsidosätter OnLoad(EventArgs) metoden för den associerade kontrollen. (Ärvd från ControlAdapter)
OnPreRender(EventArgs)	Åsidosätter OnPreRender(EventArgs) metoden för den associerade kontrollen. (Ärvd från ControlAdapter)
OnUnload(EventArgs)	Åsidosätter OnUnload(EventArgs) metoden för den associerade kontrollen. (Ärvd från ControlAdapter)
PerformDataBinding()	Binder data i datakällan för den associerade hierarkiska databundna kontrollen till adaptern.
Render(HtmlTextWriter)	Genererar den målspecifika markering för kontrollen som kontrollkortet är anslutet till. (Ärvd från WebControlAdapter)
RenderBeginTag(HtmlTextWriter)	Skapar starttaggen för webbkontrollen i markeringen som skickas till målwebbläsaren. (Ärvd från WebControlAdapter)
RenderChildren(HtmlTextWriter)	Genererar den målspecifika markering för de underordnade kontrollerna i en sammansatt kontroll som kontrollkortet är anslutet till. (Ärvd från ControlAdapter)
RenderContents(HtmlTextWriter)	Genererar den målspecifika inre markeringen för webbkontrollen som kontrollkortet är anslutet till. (Ärvd från WebControlAdapter)
RenderEndTag(HtmlTextWriter)	Skapar sluttaggen för webbkontrollen i markeringen som överförs till målwebbläsaren. (Ärvd från WebControlAdapter)
SaveAdapterControlState()	Sparar kontrolltillståndsinformation för kontrollkortet. (Ärvd från ControlAdapter)
SaveAdapterViewState()	Sparar visa tillståndsinformation för kontrollkortet. (Ärvd från ControlAdapter)
ToString()	Returnerar en sträng som representerar det aktuella objektet. (Ärvd från Object)

Gäller för

Se även

Feedback

Var den här sidan till hjälp?