HierarchicalDataBoundControlAdapter Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.UI.WebControls.Adapters

Zestaw:: System.Web.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Dostosowuje zachowanie HierarchicalDataBoundControl obiektu, z którym jest skojarzona ta karta sterowa, dla określonych żądań przeglądarki.

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

Dziedziczenie: Object

ControlAdapter

WebControlAdapter
HierarchicalDataBoundControlAdapter

Przykłady

W poniższym przykładzie kodu pokazano, jak rozszerzyć klasę w HierarchicalDataBoundControlAdapter celu renderowania kontrolki hierarchicznej TreeView powiązanej z obiektem XmlDataSource .

Ten przykład kodu zawiera cztery obiekty:

Adapter pochodzący z HierarchicalDataBoundControlAdapter klasy .
Plik aspx, który zawiera kontrolkę i zawartość specyficzną TreeView dla urządzenia.
Plik przeglądarki umożliwiający połączenie karty z typem urządzenia.
Plik XML zawierający hierarchiczną listę pracowników.

Ten przykład kodu składa się z czterech segmentów kodu. Pierwszy segment kodu pokazuje, jak rozszerzyć klasę HierarchicalDataBoundControlAdapter .

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

Drugi segment kodu pokazuje, jak zadeklarować element TreeView do powiązania ze źródłem danych XML.

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

Trzeci segment kodu pokazuje, jak połączyć kontrolkę TreeView z kartą niestandardową dla przeglądarek działających w Windows CE.

Końcowy segment kodu udostępnia dane XML, z którymi wiąże się kontrolka TreeView .

Uwagi

Klasa HierarchicalDataBoundControlAdapter dostosowuje skojarzona HierarchicalDataBoundControl kontrolkę, aby zmodyfikować domyślne znaczniki lub zachowanie dla określonej przeglądarki. Możesz rozszerzyć klasę, HierarchicalDataBoundControlAdapter aby jeszcze bardziej dostosować renderowanie kontrolki HierarchicalDataBoundControl .

Kontrolka HierarchicalDataBoundControl jest powiązana ze źródłem danych i generuje interfejs użytkownika (lub hierarchię sterowania podrzędnego, zazwyczaj), wyliczając elementy w źródle danych, do którego jest powiązana. Aby uzyskać więcej informacji na temat hierarchicznych kontrolek powiązanych z danymi, zobacz HierarchicalDataBoundControl.

Karty sterujące are.NET składników, które zarządzają co najmniej jednym etapem w cyklu życiowym kontrolki dla określonej przeglądarki. HierarchicalDataBoundControlAdapter Rozszerzenie klasy zapewnia dostęp do etapów cyklu życia kontrolkiHierarchicalDataBoundControl. Aby uzyskać więcej informacji, zobacz Omówienie architektury zachowania adaptacyjnego sterowania.

Początkowe żądanie karty powoduje, że .NET Framework wyszukać zamapowanej karty dla kontrolki, biorąc pod uwagę cechy przeglądarki żądającej. Pliki definicji przeglądarki są używane przez klasę HttpBrowserCapabilities do identyfikowania cech przeglądarki klienta i mapowania adaptera na typ przeglądarki.

Konstruktory

HierarchicalDataBoundControlAdapter()

Inicjuje nowe wystąpienie klasy HierarchicalDataBoundControlAdapter.

Właściwości

Browser	Pobiera odwołanie do możliwości przeglądarki klienta wysyłającego bieżące żądanie HTTP. (Odziedziczone po ControlAdapter)
Control	Pobiera silnie typizowane odwołanie do kontrolki skojarzonej HierarchicalDataBoundControl z tym HierarchicalDataBoundControlAdapter obiektem.
IsEnabled	Pobiera wartość wskazującą, czy kontrolka Internetowa i wszystkie jej kontrolki nadrzędne są włączone. (Odziedziczone po WebControlAdapter)
Page	Pobiera odwołanie do strony, na której znajduje się kontrolka skojarzona z tą kartą. (Odziedziczone po ControlAdapter)
PageAdapter	Pobiera odwołanie do karty strony dla strony, na której znajduje się skojarzona kontrolka. (Odziedziczone po ControlAdapter)

Metody

BeginRender(HtmlTextWriter)	Wywoływane przed renderowaniem kontrolki. W klasie karty pochodnej generuje tagi otwierające, które są wymagane przez określony element docelowy, ale nie jest wymagany przez przeglądarki HTML. (Odziedziczone po ControlAdapter)
CreateChildControls()	Tworzy kontrolki podrzędne specyficzne dla elementu docelowego dla kontrolki złożonej. (Odziedziczone po ControlAdapter)
EndRender(HtmlTextWriter)	Wywoływana po renderowaniu kontrolki. W klasie pochodnej karty generuje tagi zamykające, które są wymagane przez określony element docelowy, ale nie jest wymagany przez przeglądarki HTML. (Odziedziczone po ControlAdapter)
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
LoadAdapterControlState(Object)	Ładuje informacje o stanie kontrolki karty, które zostały zapisane SaveAdapterControlState() podczas poprzedniego żądania na stronie, na której znajduje się kontrolka skojarzona z tą kartą sterowania. (Odziedziczone po ControlAdapter)
LoadAdapterViewState(Object)	Ładuje informacje o stanie widoku karty, które zostały zapisane SaveAdapterViewState() podczas poprzedniego żądania na stronie, na której znajduje się kontrolka skojarzona z tą kartą sterowania. (Odziedziczone po ControlAdapter)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
OnInit(EventArgs)	Zastępuje metodę OnInit(EventArgs) skojarzonej kontrolki. (Odziedziczone po ControlAdapter)
OnLoad(EventArgs)	Zastępuje metodę OnLoad(EventArgs) skojarzonej kontrolki. (Odziedziczone po ControlAdapter)
OnPreRender(EventArgs)	Zastępuje metodę OnPreRender(EventArgs) skojarzonej kontrolki. (Odziedziczone po ControlAdapter)
OnUnload(EventArgs)	Zastępuje metodę OnUnload(EventArgs) skojarzonej kontrolki. (Odziedziczone po ControlAdapter)
PerformDataBinding()	Wiąże dane w źródle danych skojarzonej kontrolki powiązanej z hierarchiczną karty.
Render(HtmlTextWriter)	Generuje znacznik specyficzny dla obiektu docelowego dla kontrolki, do której jest dołączona karta sterowania. (Odziedziczone po WebControlAdapter)
RenderBeginTag(HtmlTextWriter)	Tworzy tag początku kontrolki internetowej w znaczniku, który jest przesyłany do przeglądarki docelowej. (Odziedziczone po WebControlAdapter)
RenderChildren(HtmlTextWriter)	Generuje znaczniki specyficzne dla elementu docelowego dla kontrolek podrzędnych w kontrolce złożonej, do której jest dołączony adapter sterujący. (Odziedziczone po ControlAdapter)
RenderContents(HtmlTextWriter)	Generuje wewnętrzny znacznik specyficzny dla określonego obiektu docelowego dla kontrolki internetowej, do której jest dołączona karta sterowania. (Odziedziczone po WebControlAdapter)
RenderEndTag(HtmlTextWriter)	Tworzy tag końcowy kontrolki Internetowej w znaczniku, który jest przesyłany do przeglądarki docelowej. (Odziedziczone po WebControlAdapter)
SaveAdapterControlState()	Zapisuje informacje o stanie sterowania dla karty sterującej. (Odziedziczone po ControlAdapter)
SaveAdapterViewState()	Zapisuje informacje o stanie widoku dla karty sterującej. (Odziedziczone po ControlAdapter)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Dotyczy