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 sterowania, 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

Poniższy przykład kodu pokazuje, jak rozszerzyć klasę HierarchicalDataBoundControlAdapter w celu renderowania hierarchicznej TreeView kontrolki powiązanej z obiektem XmlDataSource .

Ten przykład kodu zawiera cztery obiekty:

Adapter pochodzący z HierarchicalDataBoundControlAdapter klasy .
Plik .aspx zawierający zawartość specyficzną dla kontrolki TreeView i urządzenia.
Plik przeglądarki umożliwiający połączenie adaptera 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ć TreeView powiązanie 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 systemie Windows CE.

Końcowy segment kodu udostępnia dane XML powiązane TreeView z kontrolką.

Uwagi

Klasa HierarchicalDataBoundControlAdapter dostosowuje skojarzona HierarchicalDataBoundControl kontrolkę w celu zmodyfikowania domyślnego znaczników lub zachowania dla określonej przeglądarki. Możesz rozszerzyć klasę, HierarchicalDataBoundControlAdapter aby dodatkowo dostosować renderowanie kontrolki HierarchicalDataBoundControl .

Kontrolka HierarchicalDataBoundControl jest powiązana ze źródłem danych i generuje interfejs użytkownika (lub hierarchię kontroli podrzędnej, zwykle), 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 życia 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 adaptacyjnej kontroli.

Początkowe żądanie karty powoduje, że program .NET Framework wyszukuje zamapowany adapter dla kontrolki, biorąc pod uwagę cechy przeglądarki żądającej. Pliki definicji przeglądarki są używane przez HttpBrowserCapabilities klasę do identyfikowania cech przeglądarki klienta i mapowania karty 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 Sieci Web 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 bieżące wystąpienie. (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 znaczniki specyficzne dla elementu docelowego dla kontrolki, do której jest dołączona karta kontrolna. (Odziedziczone po WebControlAdapter)
RenderBeginTag(HtmlTextWriter)	Tworzy tag początkowy kontrolki Sieci Web w znacznikach przesyłanych do przeglądarki docelowej. (Odziedziczone po WebControlAdapter)
RenderChildren(HtmlTextWriter)	Generuje znaczniki specyficzne dla elementu docelowego dla kontrolek podrzędnych w złożonej kontrolce, do której jest dołączona karta sterowania. (Odziedziczone po ControlAdapter)
RenderContents(HtmlTextWriter)	Generuje adiustację wewnętrzną specyficzną dla elementu docelowego dla kontrolki sieci Web, do której jest dołączona karta sterowania. (Odziedziczone po WebControlAdapter)
RenderEndTag(HtmlTextWriter)	Tworzy tag końcowy kontrolki Sieci Web w znacznikach przesyłanych do przeglądarki docelowej. (Odziedziczone po WebControlAdapter)
SaveAdapterControlState()	Zapisuje informacje o stanie kontrolki 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

Udostępnij za pośrednictwem