HierarchicalDataSourceControl Classe
Definição
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.
Fornece uma classe base para os controles de fonte de dados que representam dados hierárquicos.
public ref class HierarchicalDataSourceControl abstract : System::Web::UI::Control, System::Web::UI::IHierarchicalDataSource[System.ComponentModel.Bindable(false)]
public abstract class HierarchicalDataSourceControl : System.Web.UI.Control, System.Web.UI.IHierarchicalDataSource[<System.ComponentModel.Bindable(false)>]
type HierarchicalDataSourceControl = class
inherit Control
interface IHierarchicalDataSourcePublic MustInherit Class HierarchicalDataSourceControl
Inherits Control
Implements IHierarchicalDataSource- Herança
- Derivado
- Atributos
- Implementações
Exemplos
O exemplo de código a seguir demonstra como estender a classe abstrata HierarchicalDataSourceControl e a HierarchicalDataSourceView classe e implementar as IHierarchicalEnumerable interfaces e IHierarchyData para criar um controle hierárquico de fonte de dados que recupera informações do sistema de arquivos. O FileSystemDataSource controle permite que os controles do servidor Web se associem a FileSystemInfo objetos e exibam informações básicas do sistema de arquivos. A FileSystemDataSource classe no exemplo fornece a implementação do GetHierarchicalView método , que recupera um FileSystemDataSourceView objeto . O FileSystemDataSourceView objeto recupera os dados do armazenamento de dados subjacente, nesse caso, as informações do sistema de arquivos no servidor Web. Para fins de segurança, as informações do sistema de arquivos serão exibidas somente se o controle da fonte de dados estiver sendo usado em um localhost, cenário autenticado e só começar com o diretório virtual no qual a página Web Forms usando o controle de fonte de dados reside. Por fim, duas classes que implementam IHierarchicalEnumerable e IHierarchyData são fornecidas para encapsular os FileSystemInfo objetos que FileSystemDataSource usam.
using System;
using System.Collections;
using System.IO;
using System.Runtime.InteropServices;
using System.Security.Permissions;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;
public class FileSystemDataSource :
HierarchicalDataSourceControl, IHierarchicalDataSource
{
private FileSystemDataSourceView view = null;
public FileSystemDataSource() : base() { }
protected override HierarchicalDataSourceView
GetHierarchicalView(string viewPath)
{
view = new FileSystemDataSourceView(viewPath);
return view;
}
}
public class FileSystemDataSourceView : HierarchicalDataSourceView
{
private string _viewPath;
public FileSystemDataSourceView(string viewPath)
{
HttpRequest currentRequest = HttpContext.Current.Request;
if (viewPath == "")
{
_viewPath = currentRequest.MapPath(currentRequest.ApplicationPath);
}
else
{
_viewPath = Path.Combine(
currentRequest.MapPath(currentRequest.ApplicationPath),
viewPath);
}
}
// Starting with the rootNode, recursively build a list of
// FileSystemInfo nodes, create FileSystemHierarchyData
// objects, add them all to the FileSystemHierarchicalEnumerable,
// and return the list.
public override IHierarchicalEnumerable Select()
{
HttpRequest currentRequest = HttpContext.Current.Request;
// SECURITY: There are many security issues that can be raised
// SECURITY: by exposing the file system structure of a Web server
// SECURITY: to an anonymous user in a limited trust scenario such as
// SECURITY: a Web page served on an intranet or the Internet.
// SECURITY: For this reason, the FileSystemDataSource only
// SECURITY: shows data when the HttpRequest is received
// SECURITY: from a local Web server. In addition, the data source
// SECURITY: does not display data to anonymous users.
if (currentRequest.IsAuthenticated &&
(currentRequest.UserHostAddress == "127.0.0.1" ||
currentRequest.UserHostAddress == "::1"))
{
DirectoryInfo rootDirectory = new DirectoryInfo(_viewPath);
if (!rootDirectory.Exists)
{
return null;
}
FileSystemHierarchicalEnumerable fshe =
new FileSystemHierarchicalEnumerable();
foreach (FileSystemInfo fsi
in rootDirectory.GetFileSystemInfos())
{
fshe.Add(new FileSystemHierarchyData(fsi));
}
return fshe;
}
else
{
throw new NotSupportedException(
"The FileSystemDataSource only " +
"presents data in an authenticated, localhost context.");
}
}
}
// A collection of FileSystemHierarchyData objects
public class FileSystemHierarchicalEnumerable :
ArrayList, IHierarchicalEnumerable
{
public FileSystemHierarchicalEnumerable()
: base()
{
}
public IHierarchyData GetHierarchyData(object enumeratedItem)
{
return enumeratedItem as IHierarchyData;
}
}
public class FileSystemHierarchyData : IHierarchyData
{
private FileSystemInfo fileSystemObject = null;
public FileSystemHierarchyData(FileSystemInfo obj)
{
fileSystemObject = obj;
}
public override string ToString()
{
return fileSystemObject.Name;
}
// IHierarchyData implementation.
public bool HasChildren
{
get
{
if (typeof(DirectoryInfo) == fileSystemObject.GetType())
{
DirectoryInfo temp = (DirectoryInfo)fileSystemObject;
return (temp.GetFileSystemInfos().Length > 0);
}
else
{
return false;
}
}
}
// DirectoryInfo returns the OriginalPath, while FileInfo returns
// a fully qualified path.
public string Path
{
get
{
return fileSystemObject.ToString();
}
}
public object Item
{
get
{
return fileSystemObject;
}
}
public string Type
{
get
{
return "FileSystemData";
}
}
public IHierarchicalEnumerable GetChildren()
{
FileSystemHierarchicalEnumerable children =
new FileSystemHierarchicalEnumerable();
if (typeof(DirectoryInfo) == fileSystemObject.GetType())
{
DirectoryInfo temp = (DirectoryInfo)fileSystemObject;
foreach (FileSystemInfo fsi in temp.GetFileSystemInfos())
{
children.Add(new FileSystemHierarchyData(fsi));
}
}
return children;
}
public IHierarchyData GetParent()
{
FileSystemHierarchicalEnumerable parentContainer =
new FileSystemHierarchicalEnumerable();
if (typeof(DirectoryInfo) == fileSystemObject.GetType())
{
DirectoryInfo temp = (DirectoryInfo)fileSystemObject;
return new FileSystemHierarchyData(temp.Parent);
}
else if (typeof(FileInfo) == fileSystemObject.GetType())
{
FileInfo temp = (FileInfo)fileSystemObject;
return new FileSystemHierarchyData(temp.Directory);
}
// If FileSystemObj is any other kind of FileSystemInfo, ignore it.
return null;
}
}
Imports System.Collections
Imports System.IO
Imports System.Runtime.InteropServices
Imports System.Security.Permissions
Imports System.Web
Imports System.Web.UI
Imports System.Web.UI.WebControls
Namespace Samples.AspNet
Public Class FileSystemDataSource
Inherits HierarchicalDataSourceControl
Public Sub New()
End Sub
Private view As FileSystemDataSourceView = Nothing
Protected Overrides Function GetHierarchicalView( _
ByVal viewPath As String) As HierarchicalDataSourceView
view = New FileSystemDataSourceView(viewPath)
Return view
End Function
End Class
Public Class FileSystemDataSourceView
Inherits HierarchicalDataSourceView
Private _viewPath As String
Public Sub New(ByVal viewPath As String)
Dim currentRequest As HttpRequest = HttpContext.Current.Request
If viewPath = "" Then
_viewPath = currentRequest.MapPath(currentRequest.ApplicationPath)
Else
_viewPath = Path.Combine(currentRequest.MapPath(currentRequest.ApplicationPath), viewPath)
End If
End Sub
' Starting with the rootNode, recursively build a list of
' FileSystemInfo nodes, create FileSystemHierarchyData
' objects, add them all to the FileSystemHierarchicalEnumerable,
' and return the list.
Public Overrides Function [Select]() As IHierarchicalEnumerable
Dim currentRequest As HttpRequest = HttpContext.Current.Request
' SECURITY: There are many security issues that can be raised
' SECURITY: by exposing the file system structure of a Web server
' SECURITY: to an anonymous user in a limited trust scenario such as
' SECURITY: a Web page served on an intranet or the Internet.
' SECURITY: For this reason, the FileSystemDataSource only
' SECURITY: shows data when the HttpRequest is received
' SECURITY: from a local Web server. In addition, the data source
' SECURITY: does not display data to anonymous users.
If currentRequest.IsAuthenticated AndAlso _
(currentRequest.UserHostAddress = "127.0.0.1" OrElse _
currentRequest.UserHostAddress = "::1") Then
Dim rootDirectory As New DirectoryInfo(_viewPath)
Dim fshe As New FileSystemHierarchicalEnumerable()
Dim fsi As FileSystemInfo
For Each fsi In rootDirectory.GetFileSystemInfos()
fshe.Add(New FileSystemHierarchyData(fsi))
Next fsi
Return fshe
Else
Throw New NotSupportedException( _
"The FileSystemDataSource only " + _
"presents data in an authenticated, localhost context.")
End If
End Function 'Select
End Class
Public Class FileSystemHierarchicalEnumerable
Inherits ArrayList
Implements IHierarchicalEnumerable
Public Sub New()
End Sub
Public Overridable Function GetHierarchyData( _
ByVal enumeratedItem As Object) As IHierarchyData _
Implements IHierarchicalEnumerable.GetHierarchyData
Return CType(enumeratedItem, IHierarchyData)
End Function
End Class
Public Class FileSystemHierarchyData
Implements IHierarchyData
Public Sub New(ByVal obj As FileSystemInfo)
fileSystemObject = obj
End Sub
Private fileSystemObject As FileSystemInfo = Nothing
Public Overrides Function ToString() As String
Return fileSystemObject.Name
End Function
' IHierarchyData implementation.
Public Overridable ReadOnly Property HasChildren() As Boolean _
Implements IHierarchyData.HasChildren
Get
If GetType(DirectoryInfo) Is fileSystemObject.GetType() Then
Dim temp As DirectoryInfo = _
CType(fileSystemObject, DirectoryInfo)
Return temp.GetFileSystemInfos().Length > 0
Else
Return False
End If
End Get
End Property
' DirectoryInfo returns the OriginalPath, while FileInfo returns
' a fully qualified path.
Public Overridable ReadOnly Property Path() As String _
Implements IHierarchyData.Path
Get
Return fileSystemObject.ToString()
End Get
End Property
Public Overridable ReadOnly Property Item() As Object _
Implements IHierarchyData.Item
Get
Return fileSystemObject
End Get
End Property
Public Overridable ReadOnly Property Type() As String _
Implements IHierarchyData.Type
Get
Return "FileSystemData"
End Get
End Property
Public Overridable Function GetChildren() _
As IHierarchicalEnumerable _
Implements IHierarchyData.GetChildren
Dim children As New FileSystemHierarchicalEnumerable()
If GetType(DirectoryInfo) Is fileSystemObject.GetType() Then
Dim temp As DirectoryInfo = _
CType(fileSystemObject, DirectoryInfo)
Dim fsi As FileSystemInfo
For Each fsi In temp.GetFileSystemInfos()
children.Add(New FileSystemHierarchyData(fsi))
Next fsi
End If
Return children
End Function 'GetChildren
Public Overridable Function GetParent() As IHierarchyData _
Implements IHierarchyData.GetParent
Dim parentContainer As New FileSystemHierarchicalEnumerable()
If GetType(DirectoryInfo) Is fileSystemObject.GetType() Then
Dim temp As DirectoryInfo = _
CType(fileSystemObject, DirectoryInfo)
Return New FileSystemHierarchyData(temp.Parent)
ElseIf GetType(FileInfo) Is fileSystemObject.GetType() Then
Dim temp As FileInfo = CType(fileSystemObject, FileInfo)
Return New FileSystemHierarchyData(temp.Directory)
End If
' If FileSystemObj is any other kind of FileSystemInfo, ignore it.
Return Nothing
End Function 'GetParent
End Class
End Namespace
O exemplo de código a seguir demonstra como associar declarativamente um TreeView controle aos dados do sistema de arquivos usando o FileSystemDataSource exemplo.
<%@ Page Language="C#" %>
<%@ Register Tagprefix="aspSample" Namespace="Samples.AspNet" %>
<!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>ASP.NET Example</title>
</head>
<body>
<form id="form1" runat="server">
<asp:treeview
id="TreeView1"
runat="server"
datasourceid="FileSystemDataSource1" />
<aspSample:filesystemdatasource
id = "FileSystemDataSource1"
runat = "server" />
</form>
</body>
</html>
<%@ Page Language="VB" %>
<%@ Register Tagprefix="aspSample" Namespace="Samples.AspNet" %>
<!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>ASP.NET Example</title>
</head>
<body>
<form id="form1" runat="server">
<asp:treeview
id="TreeView1"
runat="server"
datasourceid="FileSystemDataSource1" />
<aspSample:filesystemdatasource
id = "FileSystemDataSource1"
runat = "server" />
</form>
</body>
</html>
Comentários
ASP.NET dá suporte a uma arquitetura de associação de dados de controles que permite que os controles do servidor Web se associem aos dados e os apresentem de forma consistente. Os controles do servidor Web que se associam aos dados são chamados de controles associados a dados e as classes que facilitam a associação são chamadas de controles de fonte de dados. Os controles de fonte de dados podem representar qualquer fonte de dados: um arquivo, um fluxo, um banco de dados relacional, um objeto de negócios e assim por diante. Os controles de fonte de dados apresentam dados de maneira consistente para controles associados a dados, independentemente da origem ou formato dos dados subjacentes.
Os controles de fonte de dados que representam dados hierárquicos derivam da classe , enquanto os HierarchicalDataSourceControl controles de fonte de dados que representam listas ou tabelas de dados derivam da DataSourceControl classe . A HierarchicalDataSourceControl classe é a implementação base da IHierarchicalDataSource interface , que define um único método para recuperar objetos hierárquicos de exibição de fonte de dados associados ao controle da fonte de dados, GetHierarchicalView.
Você pode pensar em um controle de fonte de dados como a combinação do HierarchicalDataSourceControl objeto e suas exibições associadas nos dados subjacentes, chamados objetos de exibição da fonte de dados. Embora os controles de fonte de dados que representam dados tabulares sejam normalmente associados a apenas uma exibição nomeada, a classe dá suporte a HierarchicalDataSourceControl uma exibição de fonte de dados para cada nível de dados hierárquicos que o controle da fonte de dados representa. O nível de dados hierárquicos é identificado por um caminho hierárquico exclusivo, passado para o GetHierarchicalView método no viewPath parâmetro . Cada HierarchicalDataSourceView objeto define os recursos de um controle de fonte de dados para o nível hierárquico representado e executa operações como inserir, atualizar, excluir e classificar.
Os controles de servidor Web que derivam da HierarchicalDataBoundControl classe , como TreeView, usam controles hierárquicos de fonte de dados para associar a dados hierárquicos.
Os controles de fonte de dados são implementados como controles para habilitar a persistência declarativa e, opcionalmente, permitir a participação no gerenciamento de estado. Os controles de fonte de dados não têm renderização visual e, portanto, não dão suporte a temas.
Construtores
| HierarchicalDataSourceControl() |
Inicializa uma nova instância da classe HierarchicalDataSourceControl. |
Propriedades
| Adapter |
Obtém o adaptador específico de navegador para o controle. (Herdado de Control) |
| AppRelativeTemplateSourceDirectory |
Obtém ou define o diretório virtual relativo de aplicativo do objeto Page ou UserControl que contém este controle. (Herdado de Control) |
| BindingContainer |
Obtém o controle que contém a vinculação de dados desse controle. (Herdado de Control) |
| ChildControlsCreated |
Obtém um valor que indica se os controles filho do controle de servidor foram criados. (Herdado de Control) |
| ClientID |
Obtém o identificador de controle de servidor gerado pelo ASP.NET. |
| ClientIDMode |
Essa propriedade não é usada para controles de fonte de dados. |
| ClientIDMode |
Obtém ou define o algoritmo usado para gerar o valor da propriedade ClientID. (Herdado de Control) |
| ClientIDSeparator |
Obtém um valor de caractere que representa o caractere separador usado na propriedade ClientID. (Herdado de Control) |
| Context |
Obtém o objeto HttpContext associado ao controle de servidor para a solicitação da Web atual. (Herdado de Control) |
| Controls |
Obtém um objeto ControlCollection que representa os controles filho para um controle de servidor especificado na hierarquia de interface do usuário. |
| DataItemContainer |
Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementa o IDataItemContainer. (Herdado de Control) |
| DataKeysContainer |
Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementa o IDataKeysControl. (Herdado de Control) |
| DesignMode |
Obtém um valor que indica se um controle está sendo usado em uma superfície de design. (Herdado de Control) |
| EnableTheming |
Obtém um valor que indica se esse controle dá suporte a temas. |
| EnableViewState |
Obtém ou define um valor que indica se o controle de servidor persiste seu estado de exibição e o estado de exibição de quaisquer controles filho que ele contém, para o cliente solicitante. (Herdado de Control) |
| Events |
Obtém uma lista de delegados de manipulador de eventos para o controle. Esta propriedade é somente para leitura. (Herdado de Control) |
| HasChildViewState |
Obtém um valor que indica se os controles filho do controle de servidor atual têm alguma configuração de estado de exibição salva. (Herdado de Control) |
| ID |
Obtém ou define o identificador programático atribuído ao controle de servidor. (Herdado de Control) |
| IdSeparator |
Obtém o caractere usado para separar identificadores de controle. (Herdado de Control) |
| IsChildControlStateCleared |
Obtém um valor que indica se os controles contidos dentro deste controle têm estado de controle. (Herdado de Control) |
| IsTrackingViewState |
Obtém um valor que indica se o controle de servidor está salvando alterações no estado de exibição. (Herdado de Control) |
| IsViewStateEnabled |
Obtém um valor que indica se o estado de exibição está habilitado para esse controle. (Herdado de Control) |
| LoadViewStateByID |
Obtém um valor que indica se o controle participa do carregamento do estado de exibição por ID em vez do índice. (Herdado de Control) |
| NamingContainer |
Obtém uma referência ao contêiner de nomenclatura do controle do servidor, que cria um namespace exclusivo para diferenciar entre os controles de servidor com o mesmo valor da propriedade ID. (Herdado de Control) |
| Page |
Obtém uma referência para a instância Page que contém o controle de servidor. (Herdado de Control) |
| Parent |
Obtém uma referência ao controle pai do controle de servidor na hierarquia de controle da página. (Herdado de Control) |
| RenderingCompatibility |
Obtém um valor que especifica a versão do ASP.NET com a qual o HTML renderizado será compatível. (Herdado de Control) |
| Site |
Obtém informações sobre o contêiner que hospeda o controle atual quando renderizados em uma superfície de design. (Herdado de Control) |
| SkinID |
Obtém ou define a capa a ser aplicada ao controle HierarchicalDataSourceControl. |
| TemplateControl |
Obtém ou define uma referência ao modelo que contém este controle. (Herdado de Control) |
| TemplateSourceDirectory |
Obtém o diretório virtual do Page ou UserControl que contém o controle do servidor atual. (Herdado de Control) |
| UniqueID |
Obtém o identificador exclusivo, qualificado segundo a hierarquia, para o controle de servidor. (Herdado de Control) |
| ValidateRequestMode |
Obtém ou define um valor que indica se o controle verifica a entrada do cliente do navegador para valores potencialmente perigosos. (Herdado de Control) |
| ViewState |
Obtém um dicionário de informações de estado que permite salvar e restaurar o estado de exibição de um controle de servidor em várias solicitações para a mesma página. (Herdado de Control) |
| ViewStateIgnoresCase |
Obtém um valor que indica se o objeto StateBag não diferencia maiúsculas de minúsculas. (Herdado de Control) |
| ViewStateMode |
Obtém ou define o modo de estado de exibição deste controle. (Herdado de Control) |
| Visible |
Obtém ou define um valor indicando se o controle é exibido visualmente. |
Métodos
| AddedControl(Control, Int32) |
Chamado após um controle filho ser adicionado à coleção Controls do objeto Control. (Herdado de Control) |
| AddParsedSubObject(Object) |
Notifica o controle de servidor de que um elemento, XML ou HTML, foi analisado e adiciona o elemento ao objeto ControlCollection do controle de servidor. (Herdado de Control) |
| ApplyStyleSheetSkin(Page) |
Aplica as propriedades de estilo definidas na folha de estilos da página ao controle. |
| BeginRenderTracing(TextWriter, Object) |
Inicia o rastreamento de tempo de design de dados de renderização. (Herdado de Control) |
| BuildProfileTree(String, Boolean) |
Reúne informações sobre o controle de servidor e as envia para a propriedade Trace para serem exibidas quando o rastreamento está habilitado para a página. (Herdado de Control) |
| ClearCachedClientID() |
Define o valor ClientID armazenado em cache como |
| ClearChildControlState() |
Exclui as informações de estado de controle para os controles filho do controle de servidor. (Herdado de Control) |
| ClearChildState() |
Exclui as informações de estado de exibição e de estado de controle para todos os controles filho do controle de servidor. (Herdado de Control) |
| ClearChildViewState() |
Exclui as informações de estado de exibição para todos os controles filho do controle de servidor. (Herdado de Control) |
| ClearEffectiveClientIDMode() |
Define a propriedade ClientIDMode da instância de controle atual e de quaisquer controles filho para Inherit. (Herdado de Control) |
| CreateChildControls() |
Chamado pela estrutura de página do ASP.NET para notificar os controles do servidor que usam a implementação baseada em composição para criar os controles filho para preparar-se para um postback ou renderização. (Herdado de Control) |
| CreateControlCollection() |
Cria um novo objeto ControlCollection para manter os controles filho (literal e servidor) do controle do servidor. |
| DataBind() |
Associa uma fonte de dados ao controle de servidor chamado e a todos os seus controles filho. (Herdado de Control) |
| DataBind(Boolean) |
Associa uma fonte de dados ao controle de servidor invocado e todos os seus controles filho com uma opção para gerar o evento DataBinding. (Herdado de Control) |
| DataBindChildren() |
Associa uma fonte de dados aos controles filho do controle do servidor. (Herdado de Control) |
| Dispose() |
Permite que um controle de servidor execute a limpeza final antes do lançamento da memória. (Herdado de Control) |
| EndRenderTracing(TextWriter, Object) |
Encerra o rastreamento de tempo de design de dados de renderização. (Herdado de Control) |
| EnsureChildControls() |
Determinará se o controle de servidor contiver controles filho. Se ele não contiver, ele criará controles filho. (Herdado de Control) |
| EnsureID() |
Cria um identificador para controles que não têm um identificador atribuído. (Herdado de Control) |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| FindControl(String) |
Procura o atual contêiner de nomenclatura de um controle de servidor com o parâmetro |
| FindControl(String, Int32) |
Procura o contêiner de nomenclatura atual para um controle de servidor com o |
| Focus() |
Define o foco de entrada para o controle. |
| GetDesignModeState() |
Obtém os dados de tempo de design para um controle. (Herdado de Control) |
| GetHashCode() |
Serve como a função de hash padrão. (Herdado de Object) |
| GetHierarchicalView(String) |
Obtém o objeto auxiliar de exibição para a interface IHierarchicalDataSource para o caminho especificado. |
| GetRouteUrl(Object) |
Obtém a URL que corresponde a um conjunto de parâmetros de rota. (Herdado de Control) |
| GetRouteUrl(RouteValueDictionary) |
Obtém a URL que corresponde a um conjunto de parâmetros de rota. (Herdado de Control) |
| GetRouteUrl(String, Object) |
Obtém a URL que corresponde a um conjunto de parâmetros de rota e um nome de rota. (Herdado de Control) |
| GetRouteUrl(String, RouteValueDictionary) |
Obtém a URL que corresponde a um conjunto de parâmetros de rota e um nome de rota. (Herdado de Control) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| GetUniqueIDRelativeTo(Control) |
Retorna a parte prefixada da propriedade UniqueID do controle especificado. (Herdado de Control) |
| HasControls() |
Determina se o controle de servidor contém algum controle filho. |
| HasEvents() |
Retorna um valor que indica se os eventos são registrados para o controle ou qualquer controle filho. (Herdado de Control) |
| IsLiteralContent() |
Determina se o controle de servidor contém apenas o conteúdo literal. (Herdado de Control) |
| LoadControlState(Object) |
Restaura informações de estado de controle de uma solicitação de página anterior que foi salva pelo método SaveControlState(). (Herdado de Control) |
| LoadViewState(Object) |
Restaura informações de estado de exibição de uma solicitação de página anterior salva pelo método SaveViewState(). (Herdado de Control) |
| MapPathSecure(String) |
Recupera o caminho físico para o qual um caminho virtual é mapeado, relativo ou virtual. (Herdado de Control) |
| MemberwiseClone() |
Cria uma cópia superficial do Object atual. (Herdado de Object) |
| OnBubbleEvent(Object, EventArgs) |
Determina se o evento do controle de servidor é passado um nível acima da hierarquia de controle de servidor da interface do usuário da página. (Herdado de Control) |
| OnDataBinding(EventArgs) |
Aciona o evento DataBinding. (Herdado de Control) |
| OnDataSourceChanged(EventArgs) |
Aciona o evento DataSourceChanged. |
| OnInit(EventArgs) |
Aciona o evento Init. (Herdado de Control) |
| OnLoad(EventArgs) |
Aciona o evento Load. (Herdado de Control) |
| OnPreRender(EventArgs) |
Aciona o evento PreRender. (Herdado de Control) |
| OnUnload(EventArgs) |
Aciona o evento Unload. (Herdado de Control) |
| OpenFile(String) |
Obtém um Stream usado para ler um arquivo. (Herdado de Control) |
| RaiseBubbleEvent(Object, EventArgs) |
Atribui quaisquer fontes de evento e suas informações para o pai do controle. (Herdado de Control) |
| RemovedControl(Control) |
Chamado após um controle filho ser removido da coleção Controls do objeto Control. (Herdado de Control) |
| Render(HtmlTextWriter) |
Envia o conteúdo do controle de servidor a um objeto HtmlTextWriter fornecido, que grava o conteúdo a ser renderizado no cliente. (Herdado de Control) |
| RenderChildren(HtmlTextWriter) |
Gera o conteúdo dos filhos de um controle de servidor para um objeto HtmlTextWriter fornecido, que grava o conteúdo a ser renderizado no cliente. (Herdado de Control) |
| RenderControl(HtmlTextWriter) |
Gera o conteúdo do controle de servidor para um objeto HtmlTextWriter fornecido e armazena informações de rastreamento sobre o controle caso o rastreamento esteja habilitado. |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Gera o conteúdo do controle de servidor a um objeto HtmlTextWriter fornecido usando um objeto ControlAdapter fornecido. (Herdado de Control) |
| ResolveAdapter() |
Obtém o adaptador de controle responsável por renderizar o controle especificado. (Herdado de Control) |
| ResolveClientUrl(String) |
Obtém uma URL que pode ser usada pelo navegador. (Herdado de Control) |
| ResolveUrl(String) |
Converte uma URL em uma que possa ser usada no cliente solicitante. (Herdado de Control) |
| SaveControlState() |
Salva as alterações de estado do controle de servidor que ocorreram desde a hora em que ocorreu o postback da página no servidor. (Herdado de Control) |
| SaveViewState() |
Salva alterações de estado de exibição do controle de servidor que ocorreram desde a hora em que ocorreu o postback da página no servidor. (Herdado de Control) |
| SetDesignModeState(IDictionary) |
Define os dados de tempo de design para um controle. (Herdado de Control) |
| SetRenderMethodDelegate(RenderMethod) |
Atribui um delegado do manipulador de eventos para renderizar o controle de servidor e seu conteúdo em seu controle pai. (Herdado de Control) |
| SetTraceData(Object, Object) |
Define os dados de rastreamento para o rastreamento de tempo de design dos dados de renderização, usando a chave e o valor de dados de rastreamento. (Herdado de Control) |
| SetTraceData(Object, Object, Object) |
Define os dados de rastreamento para o rastreamento de tempo de design dos dados de renderização, usando o objeto rastreado, a chave e o valor de dados de rastreamento. (Herdado de Control) |
| ToString() |
Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object) |
| TrackViewState() |
Causa o acompanhamento das alterações de estado de exibição para o controle de servidor, para que elas possam ser armazenadas no objeto StateBag do controle de servidor. Esse objeto é acessível por meio da propriedade ViewState. (Herdado de Control) |
Eventos
| DataBinding |
Ocorre quando o controle de servidor é associado a uma fonte de dados. (Herdado de Control) |
| Disposed |
Ocorre quando um controle de servidor é liberado da memória, que é o último estágio do ciclo de vida de controle de servidor quando uma página ASP.NET é solicitada. (Herdado de Control) |
| Init |
Ocorre quando o controle de servidor é inicializado, que é a primeira etapa do ciclo de vida. (Herdado de Control) |
| Load |
Ocorre quando o controle de servidor é carregado no objeto Page. (Herdado de Control) |
| PreRender |
Ocorre depois que o objeto Control é carregado, mas antes da renderização. (Herdado de Control) |
| Unload |
Ocorre quando o controle de servidor é descarregado da memória. (Herdado de Control) |
Implantações explícitas de interface
| IControlBuilderAccessor.ControlBuilder |
Para obter uma descrição desse membro, confira ControlBuilder. (Herdado de Control) |
| IControlDesignerAccessor.GetDesignModeState() |
Para obter uma descrição desse membro, confira GetDesignModeState(). (Herdado de Control) |
| IControlDesignerAccessor.SetDesignModeState(IDictionary) |
Para obter uma descrição desse membro, confira SetDesignModeState(IDictionary). (Herdado de Control) |
| IControlDesignerAccessor.SetOwnerControl(Control) |
Para obter uma descrição desse membro, confira SetOwnerControl(Control). (Herdado de Control) |
| IControlDesignerAccessor.UserData |
Para obter uma descrição desse membro, confira UserData. (Herdado de Control) |
| IDataBindingsAccessor.DataBindings |
Para obter uma descrição desse membro, confira DataBindings. (Herdado de Control) |
| IDataBindingsAccessor.HasDataBindings |
Para obter uma descrição desse membro, confira HasDataBindings. (Herdado de Control) |
| IExpressionsAccessor.Expressions |
Para obter uma descrição desse membro, confira Expressions. (Herdado de Control) |
| IExpressionsAccessor.HasExpressions |
Para obter uma descrição desse membro, confira HasExpressions. (Herdado de Control) |
| IHierarchicalDataSource.DataSourceChanged |
Ocorre quando o HierarchicalDataSourceControl é alterado de alguma forma que afeta controles associados a dados. |
| IHierarchicalDataSource.GetHierarchicalView(String) |
Obtém o objeto auxiliar de exibição para a interface IHierarchicalDataSource para o caminho especificado. |
| IParserAccessor.AddParsedSubObject(Object) |
Para obter uma descrição desse membro, confira AddParsedSubObject(Object). (Herdado de Control) |
Métodos de Extensão
| FindDataSourceControl(Control) |
Retorna a fonte de dados associada ao controle de dados do controle especificado. |
| FindFieldTemplate(Control, String) |
Retorna o modelo do campo para a coluna especificada no contêiner de nomenclatura do controle especificado. |
| FindMetaTable(Control) |
Retorna o objeto metatable para o controle que contém dados. |
Aplica-se a
Confira também
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de