HierarchicalDataBoundControlAdapter Třída

Reference

Definice

Obor názvů:: System.Web.UI.WebControls.Adapters

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Přizpůsobí chování objektu HierarchicalDataBoundControl , ke kterému je tento adaptér ovládacího prvku přidružen pro konkrétní požadavky prohlížeče.

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

Dědičnost: Object

ControlAdapter

WebControlAdapter
HierarchicalDataBoundControlAdapter

Příklady

Následující příklad kódu ukazuje, jak rozšířit HierarchicalDataBoundControlAdapter třídu vykreslit hierarchický TreeView ovládací prvek, který je vázán na XmlDataSource objekt.

Tento příklad kódu obsahuje čtyři objekty:

Adaptér odvozený z HierarchicalDataBoundControlAdapter třídy .
.aspx soubor, který obsahuje TreeView ovládací prvek a obsah specifický pro zařízení.
Soubor prohlížeče pro propojení adaptéru s typem zařízení.
Soubor XML, který obsahuje hierarchický seznam zaměstnanců.

Tento příklad kódu se skládá ze čtyř segmentů kódu. První segment kódu ukazuje, jak rozšířit HierarchicalDataBoundControlAdapter třídu .

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

Druhý segment kódu ukazuje, jak deklarovat TreeView vazbu na zdroj dat 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>

Třetí segment kódu ukazuje, jak propojit TreeView ovládací prvek s vlastním adaptérem pro prohlížeče spuštěné v systému Windows CE.

Konečný segment kódu poskytuje data XML, se kterými se TreeView ovládací prvek sváže.

Poznámky

Třída HierarchicalDataBoundControlAdapter přizpůsobí přidružený HierarchicalDataBoundControl ovládací prvek pro úpravu výchozího kódu nebo chování pro konkrétní prohlížeč. Rozšířením HierarchicalDataBoundControlAdapter třídy můžete dále přizpůsobit vykreslování HierarchicalDataBoundControl ovládacího prvku.

Ovládací HierarchicalDataBoundControl prvek je vázán na zdroj dat a generuje své uživatelské rozhraní (nebo obvykle podřízenou hierarchii ovládacích prvků) výčtem položek ve zdroji dat, ke kterému je vázán. Další informace o hierarchických ovládacích prvcích vázaných na data najdete v tématu HierarchicalDataBoundControl.

Adaptéry ovládacích prvků are.NET komponenty, které spravují jednu nebo více fází životního cyklu ovládacího prvku pro konkrétní prohlížeč. Rozšíření HierarchicalDataBoundControlAdapter třídy poskytuje přístup k životnímu cyklu fáze HierarchicalDataBoundControl ovládacího prvku. Další informace najdete v tématu Přehled architektury chování adaptivního řízení.

Počáteční požadavek na adaptér způsobí, že rozhraní .NET Framework vyhledá mapovaný adaptér pro ovládací prvek s ohledem na charakteristiky žádajícího prohlížeče. Definiční soubory prohlížeče jsou používány HttpBrowserCapabilities třídou k identifikaci charakteristik klientského prohlížeče a mapování adaptéru na typ prohlížeče.

Konstruktory

HierarchicalDataBoundControlAdapter()

Inicializuje novou instanci HierarchicalDataBoundControlAdapter třídy .

Vlastnosti

Browser	Získá odkaz na možnosti prohlížeče klienta, který provádí aktuální požadavek HTTP. (Zděděno od ControlAdapter)
Control	Načte odkaz silného typu na HierarchicalDataBoundControl ovládací prvek přidružený k tomuto HierarchicalDataBoundControlAdapter objektu.
IsEnabled	Získá hodnotu označující, zda webový ovládací prvek a všechny jeho nadřazené ovládací prvky jsou povoleny. (Zděděno od WebControlAdapter)
Page	Získá odkaz na stránku, kde se nachází ovládací prvek přidružený k tomuto adaptéru. (Zděděno od ControlAdapter)
PageAdapter	Získá odkaz na adaptér stránky pro stránku, kde se nachází přidružený ovládací prvek. (Zděděno od ControlAdapter)

Metody

BeginRender(HtmlTextWriter)	Volána před vykreslením ovládacího prvku. V odvozené třídě adaptéru generuje otevírací značky, které jsou požadovány konkrétním cílem, ale nejsou potřeba prohlížeči HTML. (Zděděno od ControlAdapter)
CreateChildControls()	Vytvoří podřízené ovládací prvky specifické pro cíl pro složený ovládací prvek. (Zděděno od ControlAdapter)
EndRender(HtmlTextWriter)	Volána po vykreslení ovládacího prvku. V odvozené třídě adaptéru generuje koncové značky, které jsou požadovány konkrétním cílem, ale nejsou vyžadovány prohlížeči HTML. (Zděděno od ControlAdapter)
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
LoadAdapterControlState(Object)	Načte informace o stavu ovládacího prvku adaptéru, které byly uloženy SaveAdapterControlState() během předchozího požadavku, na stránku, kde se nachází ovládací prvek přidružený k tomuto adaptéru ovládacího prvku. (Zděděno od ControlAdapter)
LoadAdapterViewState(Object)	Načte informace o stavu zobrazení adaptéru uložené nástrojem SaveAdapterViewState() během předchozího požadavku na stránku, kde se nachází ovládací prvek přidružený k tomuto adaptéru ovládacího prvku. (Zděděno od ControlAdapter)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
OnInit(EventArgs)	Přepíše metodu OnInit(EventArgs) pro přidružený ovládací prvek. (Zděděno od ControlAdapter)
OnLoad(EventArgs)	Přepíše metodu OnLoad(EventArgs) pro přidružený ovládací prvek. (Zděděno od ControlAdapter)
OnPreRender(EventArgs)	Přepíše metodu OnPreRender(EventArgs) pro přidružený ovládací prvek. (Zděděno od ControlAdapter)
OnUnload(EventArgs)	Přepíše metodu OnUnload(EventArgs) pro přidružený ovládací prvek. (Zděděno od ControlAdapter)
PerformDataBinding()	Vytvoří vazbu dat ve zdroji dat přidruženého hierarchického ovládacího prvku vázaného na data k adaptéru.
Render(HtmlTextWriter)	Vygeneruje cílovou značku pro ovládací prvek, ke kterému je připojen adaptér ovládacího prvku. (Zděděno od WebControlAdapter)
RenderBeginTag(HtmlTextWriter)	Vytvoří počáteční značku webového ovládacího prvku v kódu, který je přenesen do cílového prohlížeče. (Zděděno od WebControlAdapter)
RenderChildren(HtmlTextWriter)	Vygeneruje značky specifické pro cíl pro podřízené ovládací prvky ve složeném ovládacím prvku, ke kterému je připojen adaptér ovládacího prvku. (Zděděno od ControlAdapter)
RenderContents(HtmlTextWriter)	Vygeneruje cílovou vnitřní značku webového ovládacího prvku, ke kterému je připojen adaptér ovládacího prvku. (Zděděno od WebControlAdapter)
RenderEndTag(HtmlTextWriter)	Vytvoří koncovou značku webového ovládacího prvku v kódu, který se přenese do cílového prohlížeče. (Zděděno od WebControlAdapter)
SaveAdapterControlState()	Uloží informace o stavu ovládacího prvku pro adaptér ovládacího prvku. (Zděděno od ControlAdapter)
SaveAdapterViewState()	Uloží informace o stavu zobrazení pro ovládací adaptér. (Zděděno od ControlAdapter)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Platí pro

Sdílet prostřednictvím