HierarchicalDataBoundControlAdapter Classe

Riferimento

Definizione

Spazio dei nomi:: System.Web.UI.WebControls.Adapters

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Personalizza il comportamento di un oggetto HierarchicalDataBoundControl a cui è associato l'adattatore di controllo, per richieste del browser specifiche.

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

Ereditarietà: Object

ControlAdapter

WebControlAdapter
HierarchicalDataBoundControlAdapter

Esempio

Nell'esempio di codice seguente viene illustrato come estendere la classe per eseguire il HierarchicalDataBoundControlAdapter rendering di un controllo gerarchico TreeView associato a un XmlDataSource oggetto.

Questo esempio di codice contiene quattro oggetti:

Una scheda derivata dalla HierarchicalDataBoundControlAdapter classe .
File aspx che incorpora il controllo e il contenuto specifico del TreeView dispositivo.
File del browser per collegare l'adattatore a un tipo di dispositivo.
File XML contenente un elenco gerarchico di dipendenti.

Questo esempio di codice è costituito da quattro segmenti di codice. Il primo segmento di codice illustra come estendere la HierarchicalDataBoundControlAdapter classe.

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

Il secondo segmento di codice illustra come dichiarare un TreeView oggetto da associare a un'origine dati 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>

Il terzo segmento di codice mostra come collegare il TreeView controllo alla scheda personalizzata per i browser in esecuzione in Windows CE.

Il segmento di codice finale fornisce i dati XML associati al TreeView controllo.

Commenti

La HierarchicalDataBoundControlAdapter classe adatta il controllo associato HierarchicalDataBoundControl per modificare il markup o il comportamento predefinito per un browser specifico. È possibile estendere la classe per personalizzare ulteriormente il HierarchicalDataBoundControlAdapter rendering del HierarchicalDataBoundControl controllo.

Un HierarchicalDataBoundControl controllo è associato a un'origine dati e genera la relativa interfaccia utente (o gerarchia di controllo figlio, in genere), enumerando gli elementi nell'origine dati a cui è associato. Per altre informazioni sui controlli associati a dati gerarchici, vedere HierarchicalDataBoundControl.

Gli adattatori di controllo are.NET componenti che gestiscono una o più fasi del ciclo di vita di un controllo per un browser specifico. L'estensione della HierarchicalDataBoundControlAdapter classe fornisce l'accesso alle fasi del ciclo di vita del HierarchicalDataBoundControl controllo. Per altre informazioni, vedere Panoramica dell'architettura del comportamento del controllo adattivo.

La richiesta iniziale per un adattatore causa la .NET Framework di cercare un adattatore mappato per il controllo, in base alle caratteristiche del browser di richiesta. I file di definizione del browser vengono usati dalla HttpBrowserCapabilities classe per identificare le caratteristiche del browser client e eseguire il mapping dell'adattatore al tipo di browser.

Costruttori

HierarchicalDataBoundControlAdapter()

Inizializza una nuova istanza della classe HierarchicalDataBoundControlAdapter.

Proprietà

Browser	Ottiene un riferimento alle funzionalità del browser del client che effettua la richiesta HTTP corrente. (Ereditato da ControlAdapter)
Control	Recupera un riferimento fortemente tipizzato al controllo HierarchicalDataBoundControl associato a questo oggetto HierarchicalDataBoundControlAdapter.
IsEnabled	Ottiene un valore che indica se il controllo Web e tutti i relativi controlli padre sono abilitati. (Ereditato da WebControlAdapter)
Page	Ottiene un riferimento alla pagina in cui si trova il controllo associato a questo adattatore. (Ereditato da ControlAdapter)
PageAdapter	Ottiene un riferimento all'adattatore di pagina per la pagina in cui si trova il controllo associato. (Ereditato da ControlAdapter)

Metodi

BeginRender(HtmlTextWriter)	Questo metodo viene chiamato prima di effettuare il rendering di un controllo. In una classe di adattatore derivata, genera i tag di apertura richiesti da una destinazione specifica ma non necessari per i browser HTML. (Ereditato da ControlAdapter)
CreateChildControls()	Crea i controlli figlio specifici della destinazione per un controllo composito. (Ereditato da ControlAdapter)
EndRender(HtmlTextWriter)	Questo metodo viene chiamato dopo il rendering di un controllo. In una classe di adattatore derivata, genera i tag di chiusura richiesti da una destinazione specifica ma non necessari per i browser HTML. (Ereditato da ControlAdapter)
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
LoadAdapterControlState(Object)	Carica le informazioni sullo stato di controllo dell'adattatore salvate dal metodo SaveAdapterControlState() durante una precedente richiesta alla pagina in cui si trova il controllo associato a questo adattatore di controllo. (Ereditato da ControlAdapter)
LoadAdapterViewState(Object)	Carica le informazioni sullo stato di visualizzazione dell'adattatore salvate dal metodo SaveAdapterViewState() durante una precedente richiesta alla pagina in cui si trova il controllo associato a questo adattatore di controllo. (Ereditato da ControlAdapter)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
OnInit(EventArgs)	Esegue l'override del metodo OnInit(EventArgs) per il controllo associato. (Ereditato da ControlAdapter)
OnLoad(EventArgs)	Esegue l'override del metodo OnLoad(EventArgs) per il controllo associato. (Ereditato da ControlAdapter)
OnPreRender(EventArgs)	Esegue l'override del metodo OnPreRender(EventArgs) per il controllo associato. (Ereditato da ControlAdapter)
OnUnload(EventArgs)	Esegue l'override del metodo OnUnload(EventArgs) per il controllo associato. (Ereditato da ControlAdapter)
PerformDataBinding()	Associa all'adattatore i dati nell'origine dati del controllo con associazione a dati gerarchico.
Render(HtmlTextWriter)	Genera il markup specifico della destinazione per il controllo a cui è associato l'adattatore del controllo. (Ereditato da WebControlAdapter)
RenderBeginTag(HtmlTextWriter)	Crea il tag di inizio per il controllo Web nel markup trasmesso al browser di destinazione. (Ereditato da WebControlAdapter)
RenderChildren(HtmlTextWriter)	Genera il markup specifico della destinazione per i controlli figlio in un controllo composito al quale è collegato l'adattatore del controllo. (Ereditato da ControlAdapter)
RenderContents(HtmlTextWriter)	Genera il markup interno specifico della destinazione per il controllo Web a cui è associato l'adattatore di controllo. (Ereditato da WebControlAdapter)
RenderEndTag(HtmlTextWriter)	Crea il tag di fine per il controllo Web nel markup trasmesso al browser di destinazione. (Ereditato da WebControlAdapter)
SaveAdapterControlState()	Salva le informazioni sullo stato del controllo per l'adattatore del controllo. (Ereditato da ControlAdapter)
SaveAdapterViewState()	Salva le informazioni sullo stato di visualizzazione per l'adattatore del controllo. (Ereditato da ControlAdapter)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Si applica a