HierarchicalDataBoundControlAdapter Classe

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 HierarchicalDataBoundControl oggetto a cui è associato questo 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:

Adattatore derivato dalla HierarchicalDataBoundControlAdapter classe .
Il file .aspx che incorpora il controllo e il TreeView contenuto specifico del 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 controllo TreeView alla scheda personalizzata per i browser in esecuzione in Windows CE.

Il segmento di codice finale fornisce i dati XML a cui il TreeView controllo è associato.

Commenti

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

Un HierarchicalDataBoundControl controllo è associato a un'origine dati e genera la relativa interfaccia utente (o gerarchia di controlli 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 sono.NET componenti che gestiscono una o più fasi del ciclo di vita di un controllo per un browser specifico. L'estensione della HierarchicalDataBoundControlAdapter classe consente l'accesso alle fasi del ciclo di vita del HierarchicalDataBoundControl controllo. Per altre informazioni, vedere Cenni preliminari sull'architettura del comportamento del controllo adattivo.

La richiesta iniziale di un adattatore fa sì che .NET Framework cerchi un adattatore mappato per il controllo, in base alle caratteristiche del browser richiedente. I file di definizione del browser vengono usati dalla HttpBrowserCapabilities classe per identificare le caratteristiche del browser client ed eseguire il mapping dell'adattatore al tipo di browser.

Costruttori

Nome	Descrizione
HierarchicalDataBoundControlAdapter()	Inizializza una nuova istanza della classe HierarchicalDataBoundControlAdapter.

Proprietà

Nome	Descrizione
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 HierarchicalDataBoundControl controllo associato a questo HierarchicalDataBoundControlAdapter oggetto.
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 risiede il controllo associato all'adattatore. (Ereditato da ControlAdapter)
PageAdapter	Ottiene un riferimento all'adattatore di pagina per la pagina in cui risiede il controllo associato. (Ereditato da ControlAdapter)

Metodi

Nome	Descrizione
BeginRender(HtmlTextWriter)	Chiamato prima del rendering di un controllo. In una classe adapter derivata genera 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)	Chiamato dopo il rendering di un controllo. In una classe adapter derivata genera 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 il Type dell'istanza corrente. (Ereditato da Object)
LoadAdapterControlState(Object)	Carica le informazioni sullo stato del controllo adattatore salvate da SaveAdapterControlState() durante una richiesta precedente alla pagina in cui risiede il controllo associato a questo adattatore di controllo. (Ereditato da ControlAdapter)
LoadAdapterViewState(Object)	Carica le informazioni sullo stato di visualizzazione dell'adattatore salvate da SaveAdapterViewState() durante una richiesta precedente alla pagina in cui risiede il controllo associato a questo adattatore di controllo. (Ereditato da ControlAdapter)
MemberwiseClone()	Crea una copia superficiale del Objectcorrente. (Ereditato da Object)
OnInit(EventArgs)	Esegue l'override del OnInit(EventArgs) metodo per il controllo associato. (Ereditato da ControlAdapter)
OnLoad(EventArgs)	Esegue l'override del OnLoad(EventArgs) metodo per il controllo associato. (Ereditato da ControlAdapter)
OnPreRender(EventArgs)	Esegue l'override del OnPreRender(EventArgs) metodo per il controllo associato. (Ereditato da ControlAdapter)
OnUnload(EventArgs)	Esegue l'override del OnUnload(EventArgs) metodo per il controllo associato. (Ereditato da ControlAdapter)
PerformDataBinding()	Associa i dati nell'origine dati del controllo associato a dati gerarchico associato all'adattatore.
Render(HtmlTextWriter)	Genera il markup specifico della destinazione per il controllo a cui è collegato l'adattatore di controllo. (Ereditato da WebControlAdapter)
RenderBeginTag(HtmlTextWriter)	Crea il tag iniziale 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 a cui è collegato l'adattatore di controllo. (Ereditato da ControlAdapter)
RenderContents(HtmlTextWriter)	Genera il markup interno specifico della destinazione per il controllo Web a cui è collegato l'adattatore di controllo. (Ereditato da WebControlAdapter)
RenderEndTag(HtmlTextWriter)	Crea il tag finale 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 di controllo. (Ereditato da ControlAdapter)
SaveAdapterViewState()	Salva le informazioni sullo stato di visualizzazione per l'adattatore di controllo. (Ereditato da ControlAdapter)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Si applica a

Vedi anche

Commenti e suggerimenti

Questa pagina è stata utile?