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 示しています。

このコード例には、次の 4 つのオブジェクトが含まれています。

クラスから HierarchicalDataBoundControlAdapter 派生したアダプター。
コントロールとデバイス固有のコンテンツを TreeView 組み込んだ.aspx ファイル。
アダプターをデバイスの種類にリンクするブラウザーファイル。
従業員の階層リストを含む XML ファイル。

このコード例は、4 つのコードセグメントで構成されています。最初のコードセグメントでは、クラスを拡張する方法を 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

2 番目のコードセグメントでは、を宣言 TreeView して 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>

3 番目のコードセグメントは、Windows CE で実行されているブラウザーのカスタムアダプターにコントロールをリンク TreeView する方法を示しています。

最後のコードセグメントは、コントロールがバインドする XML データを TreeView 提供します。

注釈

クラスは HierarchicalDataBoundControlAdapter 、関連付けられた HierarchicalDataBoundControl コントロールを調整して、特定のブラウザーの既定のマークアップまたは動作を変更します。クラスを HierarchicalDataBoundControlAdapter 拡張して、コントロールの HierarchicalDataBoundControl レンダリングをさらにカスタマイズできます。

HierarchicalDataBoundControlコントロールはデータソースにバインドされ、バインド先のデータソース内の項目を列挙することによって、そのユーザーインターフェイス (通常は子コントロール階層) を生成します。階層データバインドコントロールの詳細については、「」を参照してください HierarchicalDataBoundControl。

コントロールアダプター are.NET、特定のブラウザーのコントロールのライフサイクルで 1 つ以上のステージを管理するコンポーネントです。クラスを 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)

適用対象

次の方法で共有

HierarchicalDataBoundControlAdapter クラス

定義

例

注釈

コンストラクター

プロパティ

メソッド

適用対象

こちらもご覧ください

その他のリソース