HierarchicalDataBoundControlAdapter 类

定义

命名空间:: System.Web.UI.WebControls.Adapters

程序集:: System.Web.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

为特定的浏览器请求自定义与此控件适配器关联的对象的行为 HierarchicalDataBoundControl 。

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

继承: Object

ControlAdapter

WebControlAdapter
HierarchicalDataBoundControlAdapter

示例

下面的代码示例演示如何扩展HierarchicalDataBoundControlAdapter类以呈现绑定到对象的TreeView分层XmlDataSource控件。

此代码示例包含四个对象：

派生自类的 HierarchicalDataBoundControlAdapter 适配器。
包含 TreeView 控件和设备特定内容的.aspx文件。
用于将适配器链接到设备类型的浏览器文件。
包含员工分层列表的 XML 文件。

此代码示例由四个代码段组成。第一个代码段演示如何扩展 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

第二个代码段演示如何声明要绑定到 XML 数据源的 A TreeView 。

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

第三个代码段演示如何将 TreeView 控件链接到在 Windows CE 上运行的浏览器的自定义适配器。

最后一个代码段提供控件绑定到的 TreeView XML 数据。

注解

该 HierarchicalDataBoundControlAdapter 类调整关联的 HierarchicalDataBoundControl 控件以修改特定浏览器的默认标记或行为。可以扩展 HierarchicalDataBoundControlAdapter 类以进一步自定义控件的 HierarchicalDataBoundControl 呈现。

控件 HierarchicalDataBoundControl 绑定到数据源，并通过枚举绑定到的数据源中的项来生成其用户界面（或子控件层次结构）。有关分层数据绑定控件的详细信息，请参阅 HierarchicalDataBoundControl。

控件适配器.NET用于管理特定浏览器控件生命周期中的一个或多个阶段的组件。 HierarchicalDataBoundControlAdapter扩展类提供对控件生命周期阶段HierarchicalDataBoundControl的访问权限。有关详细信息，请参阅自适应控制行为的体系结构概述。

根据请求浏览器的特征，适配器的初始请求会导致 .NET Framework 搜索控件的映射适配器。类使用 HttpBrowserCapabilities 浏览器定义文件来标识客户端浏览器的特征，并将适配器映射到浏览器类型。

构造函数

名称	说明
HierarchicalDataBoundControlAdapter()	初始化 HierarchicalDataBoundControlAdapter 类的新实例。

属性

名称	说明
Browser	获取对发出当前 HTTP 请求的客户端的浏览器功能的引用。 (继承自 ControlAdapter)
Control	检索对此对象关联的HierarchicalDataBoundControl控件的HierarchicalDataBoundControlAdapter强类型引用。
IsEnabled	获取一个值，该值指示是否启用 Web 控件及其所有父控件。 (继承自 WebControlAdapter)
Page	获取对与此适配器关联的控件所在的页面的引用。 (继承自 ControlAdapter)
PageAdapter	获取对关联控件所在的页面的页面适配器的引用。 (继承自 ControlAdapter)

方法

名称	说明
BeginRender(HtmlTextWriter)	在呈现控件之前调用。在派生适配器类中，生成特定目标所需的打开标记，但 HTML 浏览器不需要这些标记。 (继承自 ControlAdapter)
CreateChildControls()	为复合控件创建特定于目标的子控件。 (继承自 ControlAdapter)
EndRender(HtmlTextWriter)	在控件呈现后调用。在派生适配器类中，生成特定目标所需的结束标记，但 HTML 浏览器不需要这些标记。 (继承自 ControlAdapter)
Equals(Object)	确定指定的对象是否等于当前对象。 (继承自 Object)
GetHashCode()	用作默认哈希函数。 (继承自 Object)
GetType()	获取当前实例的 Type。 (继承自 Object)
LoadAdapterControlState(Object)	加载在上一个请求中保存 SaveAdapterControlState() 的适配器控件状态信息，该信息指向与此控件适配器关联的控件所在的页面。 (继承自 ControlAdapter)
LoadAdapterViewState(Object)	加载在上一个请求中保存 SaveAdapterViewState() 的适配器视图状态信息，该信息指向与此控件适配器关联的控件所在的页面。 (继承自 ControlAdapter)
MemberwiseClone()	创建当前 Object的浅表副本。 (继承自 Object)
OnInit(EventArgs)	OnInit(EventArgs)重写关联控件的方法。 (继承自 ControlAdapter)
OnLoad(EventArgs)	OnLoad(EventArgs)重写关联控件的方法。 (继承自 ControlAdapter)
OnPreRender(EventArgs)	OnPreRender(EventArgs)重写关联控件的方法。 (继承自 ControlAdapter)
OnUnload(EventArgs)	OnUnload(EventArgs)重写关联控件的方法。 (继承自 ControlAdapter)
PerformDataBinding()	将关联分层数据绑定控件的数据源中的数据绑定到适配器。
Render(HtmlTextWriter)	为附加控件适配器的控件生成特定于目标的标记。 (继承自 WebControlAdapter)
RenderBeginTag(HtmlTextWriter)	在传输到目标浏览器的标记中为 Web 控件创建起始标记。 (继承自 WebControlAdapter)
RenderChildren(HtmlTextWriter)	为附加控件适配器的复合控件中的子控件生成特定于目标的标记。 (继承自 ControlAdapter)
RenderContents(HtmlTextWriter)	为附加控件适配器的 Web 控件生成特定于目标的内部标记。 (继承自 WebControlAdapter)
RenderEndTag(HtmlTextWriter)	在传输到目标浏览器的标记中为 Web 控件创建结束标记。 (继承自 WebControlAdapter)
SaveAdapterControlState()	保存控件适配器的控件状态信息。 (继承自 ControlAdapter)
SaveAdapterViewState()	保存控件适配器的视图状态信息。 (继承自 ControlAdapter)
ToString()	返回一个表示当前对象的字符串。 (继承自 Object)

适用于

另请参阅

反馈

此页面是否有帮助？