Control 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.
Define as propriedades, os métodos e os eventos compartilhados por todos os controles de servidor ASP.NET.
public ref class Control : IDisposable, System::ComponentModel::IComponent, System::Web::UI::IDataBindingsAccessor, System::Web::UI::IParserAccessor
public ref class Control : IDisposable, System::ComponentModel::IComponent, System::Web::UI::IControlBuilderAccessor, System::Web::UI::IControlDesignerAccessor, System::Web::UI::IDataBindingsAccessor, System::Web::UI::IExpressionsAccessor, System::Web::UI::IParserAccessor, System::Web::UI::IUrlResolutionService
public class Control : IDisposable, System.ComponentModel.IComponent, System.Web.UI.IDataBindingsAccessor, System.Web.UI.IParserAccessor
[System.ComponentModel.Bindable(true)]
[System.Web.UI.Themeable(false)]
public class Control : IDisposable, System.ComponentModel.IComponent, System.Web.UI.IControlBuilderAccessor, System.Web.UI.IControlDesignerAccessor, System.Web.UI.IDataBindingsAccessor, System.Web.UI.IExpressionsAccessor, System.Web.UI.IParserAccessor, System.Web.UI.IUrlResolutionService
type Control = class
interface IComponent
interface IDisposable
interface IParserAccessor
interface IDataBindingsAccessor
[<System.ComponentModel.Bindable(true)>]
[<System.Web.UI.Themeable(false)>]
type Control = class
interface IComponent
interface IDisposable
interface IParserAccessor
interface IUrlResolutionService
interface IDataBindingsAccessor
interface IControlBuilderAccessor
interface IControlDesignerAccessor
interface IExpressionsAccessor
Public Class Control
Implements IComponent, IDataBindingsAccessor, IDisposable, IParserAccessor
Public Class Control
Implements IComponent, IControlBuilderAccessor, IControlDesignerAccessor, IDataBindingsAccessor, IDisposable, IExpressionsAccessor, IParserAccessor, IUrlResolutionService
- Herança
-
Control
- Derivado
- Atributos
- Implementações
Exemplos
O exemplo a seguir demonstra um controle de servidor personalizado derivado da Control classe . A InnerContent
classe substitui o Control.Render método , verifica se a classe tem controles filho na página e determina se o primeiro filho do controle é um controle literal. Se ambas as condições forem atendidas, o método substituído gravará a cadeia de caracteres HTML <H2>Sua Mensagem:, o conteúdo do controle literal e uma marca /H2> de fechamento <na página do Web Forms.
Importante
Este exemplo tem uma caixa de texto que aceita a entrada do usuário, que é uma possível ameaça à segurança. Por padrão, ASP.NET páginas da Web validam que a entrada do usuário não inclui elementos html ou script. Para obter mais informações, consulte Visão geral de explorações de script.
using System;
using System.Web;
using System.Web.UI;
namespace SimpleControlSamples {
public class InnerContent : Control {
[System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name="Execution")]
protected override void Render(HtmlTextWriter output) {
if ( (HasControls()) && (Controls[0] is LiteralControl) ) {
output.Write("<H2>Your message : ");
Controls[0].RenderControl(output);
output.Write("</H2>");
}
}
}
}
Option Explicit
Option Strict
Imports System.Web
Imports System.Web.UI
Namespace SimpleControlSamples
Public Class InnerContent
Inherits Control
<System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="Execution")> _
Protected Overrides Sub Render(output As HtmlTextWriter)
If HasControls() And TypeOf Controls(0) Is LiteralControl Then
output.Write("<H2>Your message : ")
Controls(0).RenderControl(output)
output.Write("</H2>")
End If
End Sub
End Class
End Namespace 'SimpleControlSamples
Comentários
Essa é a classe primária da qual você deriva ao desenvolver controles de servidor ASP.NET personalizados. Control não tem recursos específicos da interface do usuário. Se você estiver criando um controle que não tem uma interface do usuário ou combina outros controles que renderizam sua própria interface do usuário, derive de Control. Se você estiver criando um controle que tenha uma interface do usuário, derive de WebControl ou qualquer controle no System.Web.UI.WebControls namespace que forneça um ponto de partida apropriado para o controle personalizado.
A Control classe é a classe base para todos os controles de servidor ASP.NET, incluindo controles personalizados, controles de usuário e páginas. ASP.NET páginas são instâncias da Page classe , que herda da Control classe e que manipulam solicitações para arquivos que têm uma extensão .aspx.
A Control classe pode ser usada direta ou indiretamente como parte da interface do usuário para seu aplicativo Web e, como tal, deve ser examinada para garantir que as práticas recomendadas para escrever código seguro e proteger aplicativos sejam seguidas.
Para obter informações gerais sobre esses tópicos, consulte Visão geral de ameaças de segurança de aplicativo Web, práticas recomendadas de política de segurança e principais conceitos de segurança. Para obter informações mais específicas, consulte Protegendo controles padrão, Como exibir mensagens de erro seguras, Como proteger contra explorações de script em um aplicativo Web aplicando codificação HTML a cadeias de caracteres e Introdução aos controles de validação.
Construtores
Control() |
Inicializa uma nova instância da classe Control. |
Propriedades
Adapter |
Obtém o adaptador específico de navegador para o controle. |
AppRelativeTemplateSourceDirectory |
Obtém ou define o diretório virtual relativo de aplicativo do objeto Page ou UserControl que contém este controle. |
BindingContainer |
Obtém o controle que contém a vinculação de dados desse controle. |
ChildControlsCreated |
Obtém um valor que indica se os controles filho do controle de servidor foram criados. |
ClientID |
Obtém a ID de controle de marcação HTML gerada pelo ASP.NET. |
ClientIDMode |
Obtém ou define o algoritmo usado para gerar o valor da propriedade ClientID. |
ClientIDSeparator |
Obtém um valor de caractere que representa o caractere separador usado na propriedade ClientID. |
Context |
Obtém o objeto HttpContext associado ao controle de servidor para a solicitação da Web atual. |
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. |
DataKeysContainer |
Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementa o IDataKeysControl. |
DesignMode |
Obtém um valor que indica se um controle está sendo usado em uma superfície de design. |
EnableTheming |
Obtém ou define um valor que indica se os temas se aplicam a esse controle. |
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. |
Events |
Obtém uma lista de delegados de manipulador de eventos para o controle. Esta propriedade é somente para leitura. |
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. |
ID |
Obtém ou define o identificador programático atribuído ao controle de servidor. |
IdSeparator |
Obtém o caractere usado para separar identificadores de controle. |
IsChildControlStateCleared |
Obtém um valor que indica se os controles contidos dentro deste controle têm estado de controle. |
IsTrackingViewState |
Obtém um valor que indica se o controle de servidor está salvando alterações no estado de exibição. |
IsViewStateEnabled |
Obtém um valor que indica se o estado de exibição está habilitado para esse controle. |
LoadViewStateByID |
Obtém um valor que indica se o controle participa do carregamento do estado de exibição por ID em vez do índice. |
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. |
Page |
Obtém uma referência para a instância Page que contém o controle de servidor. |
Parent |
Obtém uma referência ao controle pai do controle de servidor na hierarquia de controle da página. |
RenderingCompatibility |
Obtém um valor que especifica a versão do ASP.NET com a qual o HTML renderizado será compatível. |
Site |
Obtém informações sobre o contêiner que hospeda o controle atual quando renderizados em uma superfície de design. |
SkinID |
Obtém ou define a capa a ser aplicada ao controle. |
TemplateControl |
Obtém ou define uma referência ao modelo que contém este controle. |
TemplateSourceDirectory |
Obtém o diretório virtual do Page ou UserControl que contém o controle do servidor atual. |
UniqueID |
Obtém o identificador exclusivo, qualificado segundo a hierarquia, para o controle de servidor. |
ValidateRequestMode |
Obtém ou define um valor que indica se o controle verifica a entrada do cliente do navegador para valores potencialmente perigosos. |
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. |
ViewStateIgnoresCase |
Obtém um valor que indica se o objeto StateBag não diferencia maiúsculas de minúsculas. |
ViewStateMode |
Obtém ou define o modo de estado de exibição deste controle. |
Visible |
Obtém ou define um valor que indica se um controle de servidor é renderizado como uma interface do usuário na página. |
Métodos
AddedControl(Control, Int32) |
Chamado após um controle filho ser adicionado à coleção Controls do objeto 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. |
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. |
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. |
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. |
ClearChildState() |
Exclui as informações de estado de exibição e de estado de controle para todos os controles filho do controle de servidor. |
ClearChildViewState() |
Exclui as informações de estado de exibição para todos os controles filho do controle de servidor. |
ClearEffectiveClientIDMode() |
Define a propriedade ClientIDMode da instância de controle atual e de quaisquer controles filho para Inherit. |
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. |
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. |
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. |
DataBindChildren() |
Associa uma fonte de dados aos controles filho do controle do servidor. |
Dispose() |
Permite que um controle de servidor execute a limpeza final antes do lançamento da memória. |
EndRenderTracing(TextWriter, Object) |
Encerra o rastreamento de tempo de design de dados de renderização. |
EnsureChildControls() |
Determinará se o controle de servidor contiver controles filho. Se ele não contiver, ele criará controles filho. |
EnsureID() |
Cria um identificador para controles que não têm um identificador atribuído. |
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 um controle. |
GetDesignModeState() |
Obtém os dados de tempo de design para um controle. |
GetHashCode() |
Serve como a função de hash padrão. (Herdado de Object) |
GetRouteUrl(Object) |
Obtém a URL que corresponde a um conjunto de parâmetros de rota. |
GetRouteUrl(RouteValueDictionary) |
Obtém a URL que corresponde a um conjunto de parâmetros de rota. |
GetRouteUrl(String, Object) |
Obtém a URL que corresponde a um conjunto de parâmetros de rota e um nome de rota. |
GetRouteUrl(String, RouteValueDictionary) |
Obtém a URL que corresponde a um conjunto de parâmetros de rota e um nome de rota. |
GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
GetUniqueIDRelativeTo(Control) |
Retorna a parte prefixada da propriedade UniqueID do controle especificado. |
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. |
IsLiteralContent() |
Determina se o controle de servidor contém apenas o conteúdo literal. |
LoadControlState(Object) |
Restaura informações de estado de controle de uma solicitação de página anterior que foi salva pelo método SaveControlState(). |
LoadViewState(Object) |
Restaura informações de estado de exibição de uma solicitação de página anterior salva pelo método SaveViewState(). |
MapPathSecure(String) |
Recupera o caminho físico para o qual um caminho virtual é mapeado, relativo ou virtual. |
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. |
OnDataBinding(EventArgs) |
Aciona o evento DataBinding. |
OnInit(EventArgs) |
Aciona o evento Init. |
OnLoad(EventArgs) |
Aciona o evento Load. |
OnPreRender(EventArgs) |
Aciona o evento PreRender. |
OnUnload(EventArgs) |
Aciona o evento Unload. |
OpenFile(String) |
Obtém um Stream usado para ler um arquivo. |
RaiseBubbleEvent(Object, EventArgs) |
Atribui quaisquer fontes de evento e suas informações para o pai do controle. |
RemovedControl(Control) |
Chamado após um controle filho ser removido da coleção Controls do objeto 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. |
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. |
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. |
ResolveAdapter() |
Obtém o adaptador de controle responsável por renderizar o controle especificado. |
ResolveClientUrl(String) |
Obtém uma URL que pode ser usada pelo navegador. |
ResolveUrl(String) |
Converte uma URL em uma que possa ser usada no cliente solicitante. |
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. |
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. |
SetDesignModeState(IDictionary) |
Define os dados de tempo de design para um controle. |
SetRenderMethodDelegate(RenderMethod) |
Atribui um delegado do manipulador de eventos para renderizar o controle de servidor e seu conteúdo em seu controle pai. |
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. |
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. |
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. |
Eventos
DataBinding |
Ocorre quando o controle de servidor é associado a uma fonte de dados. |
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. |
Init |
Ocorre quando o controle de servidor é inicializado, que é a primeira etapa do ciclo de vida. |
Load |
Ocorre quando o controle de servidor é carregado no objeto Page. |
PreRender |
Ocorre depois que o objeto Control é carregado, mas antes da renderização. |
Unload |
Ocorre quando o controle de servidor é descarregado da memória. |
Implantações explícitas de interface
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. |