HierarchicalDataBoundControlAdapter Sınıf

Başvuru

Tanım

Ad Alanı:: System.Web.UI.WebControls.Adapters

Bütünleştirilmiş Kod:: System.Web.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Belirli tarayıcı istekleri için bu denetim bağdaştırıcısının ilişkilendirildiği nesnenin HierarchicalDataBoundControl davranışını özelleştirir.

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

Devralma: Object

ControlAdapter

WebControlAdapter
HierarchicalDataBoundControlAdapter

Örnekler

Aşağıdaki kod örneği, bir nesneye bağlı XmlDataSource hiyerarşik TreeView denetimi işlemek için sınıfın nasıl genişletildiğini HierarchicalDataBoundControlAdapter gösterir.

Bu kod örneği dört nesne içerir:

sınıfından HierarchicalDataBoundControlAdapter türetilmiş bir bağdaştırıcı.
Denetimi ve cihaza özgü içeriği içeren TreeView .aspx dosyası.
Bağdaştırıcıyı bir cihaz türüne bağlamak için bir tarayıcı dosyası.
Çalışanların hiyerarşik listesini içeren bir XML dosyası.

Bu kod örneği dört kod kesiminden oluşur. İlk kod kesimi, sınıfın HierarchicalDataBoundControlAdapter nasıl genişlet yapılacağını gösterir.

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

İkinci kod kesimi, xml veri kaynağına bağlanmak için nasıl TreeView bildirileceğini gösterir.

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

Üçüncü kod kesimi, denetimin TreeView Windows CE üzerinde çalışan tarayıcılar için özel bağdaştırıcıya nasıl bağlandığını gösterir.

Son kod kesimi, denetimin bağlandığını TreeView XML verilerini sağlar.

Açıklamalar

sınıfı, HierarchicalDataBoundControlAdapter belirli bir tarayıcının varsayılan işaretlemesini veya davranışını değiştirmek için ilişkili HierarchicalDataBoundControl denetimi uyarlar. Denetimin işlenmesini HierarchicalDataBoundControlAdapter daha da özelleştirmek için sınıfını HierarchicalDataBoundControl genişletebilirsiniz.

Denetim HierarchicalDataBoundControl bir veri kaynağına bağlıdır ve bağlı olduğu veri kaynağındaki öğeleri numaralandırarak kullanıcı arabirimini (veya genellikle alt denetim hiyerarşisini) oluşturur. Hiyerarşik verilere bağlı denetimler hakkında daha fazla bilgi için bkz HierarchicalDataBoundControl. .

Denetim bağdaştırıcıları, belirli bir tarayıcı için denetimin yaşam döngüsünde bir veya daha fazla aşamayı yöneten bileşenler are.NET. sınıfını HierarchicalDataBoundControlAdapter genişletmek, denetimin yaşam döngüsü aşamalarına HierarchicalDataBoundControl erişim sağlar. Daha fazla bilgi için bkz. Uyarlamalı Denetim Davranışına Mimari Genel Bakış.

Bir bağdaştırıcının ilk isteği, .NET Framework istekte bulunan tarayıcının özellikleri göz önünde bulundurularak denetim için eşlenmiş bir bağdaştırıcıyı aramasına neden olur. Tarayıcı tanım dosyaları, istemci tarayıcısının HttpBrowserCapabilities özelliklerini tanımlamak ve bağdaştırıcıyı tarayıcı türüne eşlemek için sınıfı tarafından kullanılır.

Oluşturucular

HierarchicalDataBoundControlAdapter()

HierarchicalDataBoundControlAdapter sınıfının yeni bir örneğini başlatır.

Özellikler

Browser	Geçerli HTTP isteğini yapan istemcinin tarayıcı özelliklerine bir başvuru alır. (Devralındığı yer: ControlAdapter)
Control	Bu HierarchicalDataBoundControlAdapter nesneyle ilişkili denetime HierarchicalDataBoundControl kesin olarak belirlenmiş bir başvuru alır.
IsEnabled	Web denetiminin ve tüm üst denetimlerinin etkinleştirilip etkinleştirilmeyeceğini gösteren bir değer alır. (Devralındığı yer: WebControlAdapter)
Page	Bu bağdaştırıcıyla ilişkili denetimin bulunduğu sayfaya başvuru alır. (Devralındığı yer: ControlAdapter)
PageAdapter	İlişkili denetimin bulunduğu sayfanın sayfa bağdaştırıcısına başvuru alır. (Devralındığı yer: ControlAdapter)

Yöntemler

BeginRender(HtmlTextWriter)	Denetimin işlenmesinden önce çağrılır. Türetilmiş bir bağdaştırıcı sınıfında, belirli bir hedef için gerekli olan ancak HTML tarayıcıları için gerekli olmayan açma etiketleri oluşturur. (Devralındığı yer: ControlAdapter)
CreateChildControls()	Bileşik denetim için hedefe özgü alt denetimleri oluşturur. (Devralındığı yer: ControlAdapter)
EndRender(HtmlTextWriter)	Denetimin işlenmesinden sonra çağrılır. Türetilmiş bir bağdaştırıcı sınıfında, belirli bir hedef için gerekli olan ancak HTML tarayıcıları için gerekli olmayan kapanış etiketleri oluşturur. (Devralındığı yer: ControlAdapter)
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
LoadAdapterControlState(Object)	Önceki bir istek sırasında tarafından SaveAdapterControlState() bu denetim bağdaştırıcısıyla ilişkili denetimin bulunduğu sayfaya kaydedilen bağdaştırıcı denetim durumu bilgilerini yükler. (Devralındığı yer: ControlAdapter)
LoadAdapterViewState(Object)	Bu denetim bağdaştırıcısıyla ilişkili denetimin bulunduğu sayfaya önceki bir istek sırasında tarafından SaveAdapterViewState() kaydedilen bağdaştırıcı görünüm durumu bilgilerini yükler. (Devralındığı yer: ControlAdapter)
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
OnInit(EventArgs)	OnInit(EventArgs) İlişkili denetim için yöntemini geçersiz kılar. (Devralındığı yer: ControlAdapter)
OnLoad(EventArgs)	OnLoad(EventArgs) İlişkili denetim için yöntemini geçersiz kılar. (Devralındığı yer: ControlAdapter)
OnPreRender(EventArgs)	OnPreRender(EventArgs) İlişkili denetim için yöntemini geçersiz kılar. (Devralındığı yer: ControlAdapter)
OnUnload(EventArgs)	OnUnload(EventArgs) İlişkili denetim için yöntemini geçersiz kılar. (Devralındığı yer: ControlAdapter)
PerformDataBinding()	İlişkili hiyerarşik veri bağlı denetiminin veri kaynağındaki verileri bağdaştırıcıya bağlar.
Render(HtmlTextWriter)	Denetim bağdaştırıcısının eklendiği denetim için hedefe özgü biçimlendirmeyi oluşturur. (Devralındığı yer: WebControlAdapter)
RenderBeginTag(HtmlTextWriter)	Hedef tarayıcıya aktarılan biçimlendirmede Web denetimi için başlangıç etiketini oluşturur. (Devralındığı yer: WebControlAdapter)
RenderChildren(HtmlTextWriter)	Denetim bağdaştırıcısının bağlı olduğu bileşik denetimde alt denetimler için hedefe özgü işaretlemeyi oluşturur. (Devralındığı yer: ControlAdapter)
RenderContents(HtmlTextWriter)	Denetim bağdaştırıcısının eklendiği Web denetimi için hedefe özgü iç biçimlendirmeyi oluşturur. (Devralındığı yer: WebControlAdapter)
RenderEndTag(HtmlTextWriter)	Hedef tarayıcıya aktarılan biçimlendirmede Web denetimi için bitiş etiketini oluşturur. (Devralındığı yer: WebControlAdapter)
SaveAdapterControlState()	Denetim bağdaştırıcısı için denetim durumu bilgilerini kaydeder. (Devralındığı yer: ControlAdapter)
SaveAdapterViewState()	Denetim bağdaştırıcısı için görünüm durumu bilgilerini kaydeder. (Devralındığı yer: ControlAdapter)
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)

Şunlara uygulanır