HierarchicalDataBoundControlAdapter Kelas

Referensi

Definisi

Ruang nama:: System.Web.UI.WebControls.Adapters

Rakitan:: System.Web.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Menyesuaikan perilaku HierarchicalDataBoundControl objek yang dikaitkan dengan adaptor kontrol ini, untuk permintaan browser tertentu.

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

Warisan: Object

ControlAdapter

WebControlAdapter
HierarchicalDataBoundControlAdapter

Contoh

Contoh kode berikut menunjukkan cara memperluas HierarchicalDataBoundControlAdapter kelas untuk merender kontrol hierarkis TreeView yang terikat ke XmlDataSource objek.

Contoh kode ini berisi empat objek:

Adaptor yang berasal dari HierarchicalDataBoundControlAdapter kelas .
File .aspx yang menggabungkan TreeView kontrol dan konten khusus perangkat.
File browser untuk menautkan adaptor ke jenis perangkat.
File XML yang berisi daftar hierarkis karyawan.

Contoh kode ini terdiri dari empat segmen kode. Segmen kode pertama menunjukkan cara memperluas HierarchicalDataBoundControlAdapter kelas.

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

Segmen kode kedua menunjukkan cara mendeklarasikan TreeView untuk mengikat ke sumber data 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>

Segmen kode ketiga menunjukkan cara menautkan TreeView kontrol ke adaptor kustom untuk browser yang berjalan di Windows CE.

Segmen kode akhir menyediakan data XML yang diikat TreeView kontrol.

Keterangan

Kelas HierarchicalDataBoundControlAdapter mengadaptasi HierarchicalDataBoundControl kontrol terkait untuk memodifikasi markup atau perilaku default untuk browser tertentu. Anda dapat memperluas HierarchicalDataBoundControlAdapter kelas untuk menyesuaikan penyajian HierarchicalDataBoundControl kontrol lebih lanjut.

HierarchicalDataBoundControl Kontrol terikat ke sumber data dan menghasilkan antarmuka penggunanya (atau hierarki kontrol anak, biasanya), dengan menghitung item di sumber data yang terikat. Untuk informasi selengkapnya tentang kontrol terikat data hierarkis, lihat HierarchicalDataBoundControl.

Mengontrol adaptor are.NET komponen yang mengelola satu atau beberapa tahap dalam siklus hidup kontrol untuk browser tertentu. Memperluas HierarchicalDataBoundControlAdapter kelas menyediakan akses ke tahap HierarchicalDataBoundControl siklus hidup kontrol. Untuk informasi selengkapnya, lihat Gambaran Umum Arsitektur Perilaku Kontrol Adaptif.

Permintaan awal untuk adaptor menyebabkan .NET Framework mencari adaptor yang dipetakan untuk kontrol, mengingat karakteristik browser yang meminta. File definisi browser digunakan oleh HttpBrowserCapabilities kelas untuk mengidentifikasi karakteristik browser klien dan memetakan adaptor ke jenis browser.

Konstruktor

HierarchicalDataBoundControlAdapter()

Menginisialisasi instans baru kelas HierarchicalDataBoundControlAdapter.

Properti

Browser	Mendapatkan referensi ke kemampuan browser klien yang membuat permintaan HTTP saat ini. (Diperoleh dari ControlAdapter)
Control	Mengambil referensi yang sangat diketik ke kontrol yang HierarchicalDataBoundControl terkait dengan objek ini HierarchicalDataBoundControlAdapter .
IsEnabled	Mendapatkan nilai yang menunjukkan apakah kontrol Web dan semua kontrol induknya diaktifkan. (Diperoleh dari WebControlAdapter)
Page	Mendapatkan referensi ke halaman tempat kontrol yang terkait dengan adaptor ini berada. (Diperoleh dari ControlAdapter)
PageAdapter	Mendapatkan referensi ke adaptor halaman untuk halaman tempat kontrol terkait berada. (Diperoleh dari ControlAdapter)

Metode

BeginRender(HtmlTextWriter)	Dipanggil sebelum penyajian kontrol. Di kelas adaptor turunan, menghasilkan tag pembuka yang diperlukan oleh target tertentu tetapi tidak diperlukan oleh browser HTML. (Diperoleh dari ControlAdapter)
CreateChildControls()	Membuat kontrol turunan khusus target untuk kontrol komposit. (Diperoleh dari ControlAdapter)
EndRender(HtmlTextWriter)	Dipanggil setelah penyajian kontrol. Di kelas adaptor turunan, menghasilkan tag penutup yang diperlukan oleh target tertentu tetapi tidak diperlukan oleh browser HTML. (Diperoleh dari ControlAdapter)
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan instans Type saat ini. (Diperoleh dari Object)
LoadAdapterControlState(Object)	Memuat informasi status kontrol adaptor yang disimpan selama SaveAdapterControlState() permintaan sebelumnya ke halaman tempat kontrol yang terkait dengan adaptor kontrol ini berada. (Diperoleh dari ControlAdapter)
LoadAdapterViewState(Object)	Memuat informasi status tampilan adaptor yang disimpan selama SaveAdapterViewState() permintaan sebelumnya ke halaman tempat kontrol yang terkait dengan adaptor kontrol ini berada. (Diperoleh dari ControlAdapter)
MemberwiseClone()	Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
OnInit(EventArgs)	Mengambil alih OnInit(EventArgs) metode untuk kontrol terkait. (Diperoleh dari ControlAdapter)
OnLoad(EventArgs)	Mengambil alih OnLoad(EventArgs) metode untuk kontrol terkait. (Diperoleh dari ControlAdapter)
OnPreRender(EventArgs)	Mengambil alih OnPreRender(EventArgs) metode untuk kontrol terkait. (Diperoleh dari ControlAdapter)
OnUnload(EventArgs)	Mengambil alih OnUnload(EventArgs) metode untuk kontrol terkait. (Diperoleh dari ControlAdapter)
PerformDataBinding()	Mengikat data di sumber data kontrol terikat data hierarkis terkait ke adaptor.
Render(HtmlTextWriter)	Menghasilkan markup khusus target untuk kontrol tempat adaptor kontrol terpasang. (Diperoleh dari WebControlAdapter)
RenderBeginTag(HtmlTextWriter)	Membuat tag awal untuk kontrol Web di markup yang dikirimkan ke browser target. (Diperoleh dari WebControlAdapter)
RenderChildren(HtmlTextWriter)	Menghasilkan markup khusus target untuk kontrol anak dalam kontrol komposit tempat adaptor kontrol dilampirkan. (Diperoleh dari ControlAdapter)
RenderContents(HtmlTextWriter)	Menghasilkan markup dalam khusus target untuk kontrol Web tempat adaptor kontrol dilampirkan. (Diperoleh dari WebControlAdapter)
RenderEndTag(HtmlTextWriter)	Membuat tag akhir untuk kontrol Web dalam markup yang dikirimkan ke browser target. (Diperoleh dari WebControlAdapter)
SaveAdapterControlState()	Menyimpan informasi status kontrol untuk adaptor kontrol. (Diperoleh dari ControlAdapter)
SaveAdapterViewState()	Menyimpan informasi status tampilan untuk adaptor kontrol. (Diperoleh dari ControlAdapter)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Berlaku untuk

Bagikan melalui