HierarchicalDataBoundControlAdapter Clase

Definición

Espacio de nombres:
System.Web.UI.WebControls.Adapters
Ensamblado:
System.Web.dll

Personaliza el comportamiento de un HierarchicalDataBoundControl objeto con el que está asociado este adaptador de control para solicitudes específicas del explorador.

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
Herencia
Object
ControlAdapter
WebControlAdapter
HierarchicalDataBoundControlAdapter

Ejemplos

En el ejemplo de código siguiente se muestra cómo extender la HierarchicalDataBoundControlAdapter clase para representar un control jerárquico TreeView enlazado a un XmlDataSource objeto .

Este ejemplo de código contiene cuatro objetos:

  • Un adaptador derivado de la HierarchicalDataBoundControlAdapter clase .

  • El archivo .aspx que incorpora el control y el contenido específico del TreeView dispositivo.

  • Un archivo del explorador para vincular el adaptador a un tipo de dispositivo.

  • Un archivo XML que contiene una lista jerárquica de empleados.

Este ejemplo de código consta de cuatro segmentos de código. El primer segmento de código muestra cómo extender la HierarchicalDataBoundControlAdapter clase .

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

El segundo segmento de código muestra cómo declarar un TreeView objeto para enlazar a un origen de datos 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>

El tercer segmento de código muestra cómo vincular el control /TreeView al adaptador personalizado para exploradores que se ejecutan en Windows CE.

El segmento de código final proporciona los datos XML a los que se enlaza el TreeView control.

Comentarios

La HierarchicalDataBoundControlAdapter clase adapta el control asociado HierarchicalDataBoundControl para modificar el marcado predeterminado o el comportamiento de un explorador específico. Puede ampliar la clase para personalizar aún más la HierarchicalDataBoundControlAdapter representación del HierarchicalDataBoundControl control.

Un HierarchicalDataBoundControl control se enlaza a un origen de datos y genera su interfaz de usuario (o jerarquía de controles secundarios, normalmente), enumerando los elementos del origen de datos al que está enlazado. Para obtener más información sobre los controles enlazados a datos jerárquicos, vea HierarchicalDataBoundControl.

Los adaptadores de control son.NET componentes que administran una o varias fases en el ciclo de vida de un control para un explorador específico. Extender la HierarchicalDataBoundControlAdapter clase proporciona acceso a las fases del ciclo de vida del HierarchicalDataBoundControl control. Para obtener más información, consulte Introducción a la arquitectura del comportamiento del control adaptable.

La solicitud inicial de un adaptador hace que .NET Framework busque un adaptador asignado para el control, dadas las características del explorador solicitante. La HttpBrowserCapabilities clase usa los archivos de definición del explorador para identificar las características del explorador cliente y asignar el adaptador al tipo de explorador.

Constructores

Nombre Description
HierarchicalDataBoundControlAdapter()

Inicializa una nueva instancia de la clase HierarchicalDataBoundControlAdapter.

Propiedades

Nombre Description
Browser

Obtiene una referencia a las funcionalidades del explorador del cliente que realiza la solicitud HTTP actual.

(Heredado de ControlAdapter)
Control

Recupera una referencia fuertemente tipada al HierarchicalDataBoundControl control asociado a este HierarchicalDataBoundControlAdapter objeto.
IsEnabled

Obtiene un valor que indica si el control Web y todos sus controles primarios están habilitados.

(Heredado de WebControlAdapter)
Page

Obtiene una referencia a la página donde reside el control asociado a este adaptador.

(Heredado de ControlAdapter)
PageAdapter

Obtiene una referencia al adaptador de página de la página donde reside el control asociado.

(Heredado de ControlAdapter)

Métodos

Nombre Description
BeginRender(HtmlTextWriter)

Se llama antes de la representación de un control. En una clase de adaptador derivada, genera etiquetas de apertura necesarias para un destino específico, pero no necesarias para los exploradores HTML.

(Heredado de ControlAdapter)
CreateChildControls()

Crea los controles secundarios específicos del destino para un control compuesto.

(Heredado de ControlAdapter)
EndRender(HtmlTextWriter)

Se llama después de la representación de un control. En una clase de adaptador derivada, genera etiquetas de cierre necesarias para un destino específico, pero que no son necesarias para los exploradores HTML.

(Heredado de ControlAdapter)
Equals(Object)

Determina si el objeto especificado es igual al objeto actual.

(Heredado de Object)
GetHashCode()

Actúa como función hash predeterminada.

(Heredado de Object)
GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
LoadAdapterControlState(Object)

Carga la información de estado del control del adaptador que guardó SaveAdapterControlState() durante una solicitud anterior a la página donde reside el control asociado a este adaptador de control.

(Heredado de ControlAdapter)
LoadAdapterViewState(Object)

Carga la información de estado de vista del adaptador guardada por SaveAdapterViewState() durante una solicitud anterior a la página donde reside el control asociado a este adaptador de control.

(Heredado de ControlAdapter)
MemberwiseClone()

Crea una copia superficial del Objectactual.

(Heredado de Object)
OnInit(EventArgs)

Invalida el OnInit(EventArgs) método para el control asociado.

(Heredado de ControlAdapter)
OnLoad(EventArgs)

Invalida el OnLoad(EventArgs) método para el control asociado.

(Heredado de ControlAdapter)
OnPreRender(EventArgs)

Invalida el OnPreRender(EventArgs) método para el control asociado.

(Heredado de ControlAdapter)
OnUnload(EventArgs)

Invalida el OnUnload(EventArgs) método para el control asociado.

(Heredado de ControlAdapter)
PerformDataBinding()

Enlaza los datos del origen de datos del control jerárquico enlazado a datos asociado al adaptador.
Render(HtmlTextWriter)

Genera el marcado específico del destino para el control al que está asociado el adaptador de control.

(Heredado de WebControlAdapter)
RenderBeginTag(HtmlTextWriter)

Crea la etiqueta inicial para el control Web en el marcado que se transmite al explorador de destino.

(Heredado de WebControlAdapter)
RenderChildren(HtmlTextWriter)

Genera el marcado específico del destino para los controles secundarios en un control compuesto al que está asociado el adaptador de control.

(Heredado de ControlAdapter)
RenderContents(HtmlTextWriter)

Genera el marcado interno específico del destino para el control web al que está asociado el adaptador de control.

(Heredado de WebControlAdapter)
RenderEndTag(HtmlTextWriter)

Crea la etiqueta final para el control Web en el marcado que se transmite al explorador de destino.

(Heredado de WebControlAdapter)
SaveAdapterControlState()

Guarda la información de estado del control para el adaptador de control.

(Heredado de ControlAdapter)
SaveAdapterViewState()

Guarda la información de estado de vista del adaptador de control.

(Heredado de ControlAdapter)
ToString()

Devuelve una cadena que representa el objeto actual.

(Heredado de Object)

Se aplica a

Consulte también