HierarchicalDataBoundControlAdapter Classe

Definição

Namespace:: System.Web.UI.WebControls.Adapters

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Personaliza o comportamento de um HierarchicalDataBoundControl objeto com o qual esse adaptador de controle está associado, para solicitações específicas do navegador.

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

Herança: Object

ControlAdapter

WebControlAdapter
HierarchicalDataBoundControlAdapter

Exemplos

O exemplo de código a seguir mostra como estender a HierarchicalDataBoundControlAdapter classe para renderizar um controle hierárquico TreeView associado a um XmlDataSource objeto.

Este exemplo de código contém quatro objetos:

Um adaptador derivado da HierarchicalDataBoundControlAdapter classe.
O arquivo .aspx que incorpora o controle e o TreeView conteúdo específico do dispositivo.
Um arquivo do navegador para vincular o adaptador a um tipo de dispositivo.
Um arquivo XML que contém uma lista hierárquica de funcionários.

Este exemplo de código consiste em quatro segmentos de código. O primeiro segmento de código demonstra como estender a 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

O segundo segmento de código demonstra como declarar uma TreeView associação a uma fonte de dados 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>

O terceiro segmento de código mostra como vincular o controle TreeView ao adaptador personalizado para navegadores em execução no Windows CE.

O segmento de código final fornece os dados XML aos quais o TreeView controle se associa.

Comentários

A HierarchicalDataBoundControlAdapter classe adapta o controle associado HierarchicalDataBoundControl para modificar a marcação ou o comportamento padrão de um navegador específico. Você pode estender a HierarchicalDataBoundControlAdapter classe para personalizar ainda mais a renderização do HierarchicalDataBoundControl controle.

Um HierarchicalDataBoundControl controle é associado a uma fonte de dados e gera sua interface do usuário (ou hierarquia de controle filho, normalmente), enumerando os itens na fonte de dados à qual ele está associado. Para obter mais informações sobre controles hierárquicos associados a dados, consulte HierarchicalDataBoundControl.

Os adaptadores de controle são.NET componentes que gerenciam um ou mais estágios no ciclo de vida de um controle para um navegador específico. Estender a HierarchicalDataBoundControlAdapter classe fornece acesso aos estágios do ciclo de vida do HierarchicalDataBoundControl controle. Para obter mais informações, consulte Visão geral da arquitetura do comportamento do controle adaptável.

A solicitação inicial de um adaptador faz com que o .NET Framework pesquise um adaptador mapeado para o controle, considerando as características do navegador solicitante. Os arquivos de definição do HttpBrowserCapabilities navegador são usados pela classe para identificar as características do navegador cliente e mapear o adaptador para o tipo de navegador.

Construtores

Nome	Description
HierarchicalDataBoundControlAdapter()	Inicializa uma nova instância da classe HierarchicalDataBoundControlAdapter.

Propriedades

Nome	Description
Browser	Obtém uma referência aos recursos do navegador do cliente que está fazendo a solicitação HTTP atual. (Herdado de ControlAdapter)
Control	Recupera uma referência fortemente tipada para o controle associado a HierarchicalDataBoundControl esse HierarchicalDataBoundControlAdapter objeto.
IsEnabled	Obtém um valor que indica se o controle Web e todos os seus controles pai estão habilitados. (Herdado de WebControlAdapter)
Page	Obtém uma referência à página em que reside o controle associado a esse adaptador. (Herdado de ControlAdapter)
PageAdapter	Obtém uma referência ao adaptador de página da página em que reside o controle associado. (Herdado de ControlAdapter)

Métodos

Nome	Description
BeginRender(HtmlTextWriter)	Chamado antes da renderização de um controle. Em uma classe de adaptador derivada, gera marcas de abertura que são exigidas por um destino específico, mas não necessárias para navegadores HTML. (Herdado de ControlAdapter)
CreateChildControls()	Cria os controles filho específicos de destino para um controle composto. (Herdado de ControlAdapter)
EndRender(HtmlTextWriter)	Chamado após a renderização de um controle. Em uma classe de adaptador derivada, gera marcas de fechamento que são exigidas por um destino específico, mas não necessárias para navegadores HTML. (Herdado de ControlAdapter)
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função hash predefinida. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
LoadAdapterControlState(Object)	Carrega informações de estado de controle do adaptador que foram salvas durante SaveAdapterControlState() uma solicitação anterior à página em que o controle associado a esse adaptador de controle reside. (Herdado de ControlAdapter)
LoadAdapterViewState(Object)	Carrega informações de estado de exibição do adaptador que foram salvas durante SaveAdapterViewState() uma solicitação anterior para a página em que o controle associado a esse adaptador de controle reside. (Herdado de ControlAdapter)
MemberwiseClone()	Cria uma cópia superficial do Objectatual. (Herdado de Object)
OnInit(EventArgs)	Substitui o OnInit(EventArgs) método para o controle associado. (Herdado de ControlAdapter)
OnLoad(EventArgs)	Substitui o OnLoad(EventArgs) método para o controle associado. (Herdado de ControlAdapter)
OnPreRender(EventArgs)	Substitui o OnPreRender(EventArgs) método para o controle associado. (Herdado de ControlAdapter)
OnUnload(EventArgs)	Substitui o OnUnload(EventArgs) método para o controle associado. (Herdado de ControlAdapter)
PerformDataBinding()	Associa os dados na fonte de dados do controle hierárquico associado a dados associados ao adaptador.
Render(HtmlTextWriter)	Gera a marcação específica de destino para o controle ao qual o adaptador de controle está anexado. (Herdado de WebControlAdapter)
RenderBeginTag(HtmlTextWriter)	Cria a marcação inicial para o controle Web na marcação transmitida para o navegador de destino. (Herdado de WebControlAdapter)
RenderChildren(HtmlTextWriter)	Gera a marcação específica de destino para os controles filho em um controle composto ao qual o adaptador de controle está anexado. (Herdado de ControlAdapter)
RenderContents(HtmlTextWriter)	Gera a marcação interna específica de destino para o controle Web ao qual o adaptador de controle está anexado. (Herdado de WebControlAdapter)
RenderEndTag(HtmlTextWriter)	Cria a marca final para o controle Web na marcação transmitida para o navegador de destino. (Herdado de WebControlAdapter)
SaveAdapterControlState()	Salva informações de estado de controle para o adaptador de controle. (Herdado de ControlAdapter)
SaveAdapterViewState()	Salva informações de estado de exibição para o adaptador de controle. (Herdado de ControlAdapter)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Aplica-se a

Confira também

Comentários

Esta página foi útil?