Control Classe

Definição

Namespace:: System.Web.UI

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.

Define as propriedades, métodos e 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: Object
Control

Derivado: System.Web.DynamicData.DynamicControl

System.Web.DynamicData.DynamicDataManager

System.Web.DynamicData.DynamicEntity

System.Web.DynamicData.DynamicFilter

System.Web.DynamicData.EntityTemplate

Mais…

Atributos: BindableAttribute ThemeableAttribute

Implementações: IComponent IDisposable IDataBindingsAccessor IParserAccessor IControlBuilderAccessor IControlDesignerAccessor IExpressionsAccessor IUrlResolutionService

Exemplos

O exemplo a seguir demonstra um controle de servidor personalizado que deriva 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 de fechamento </H2> na página do Web Forms.

Importante

Este exemplo tem uma caixa de texto que aceita a entrada do usuário, que é uma potencial ameaça à segurança. Por padrão, ASP.NET páginas da Web validam que a entrada do usuário não inclui elementos de script ou HTML. Para obter mais informações, consulte Visão geral das 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 quando desenvolve controles de servidor ASP.NET personalizados. Control não tem nenhum recurso específico da interface do usuário (interface do usuário). Se você estiver criando um controle que não tenha uma interface do usuário ou combine outros controles que renderizem sua própria interface do usuário, derive de Control. Se você estiver criando um controle que tenha uma interface do WebControl usuário, derive ou qualquer controle no System.Web.UI.WebControls namespace que forneça um ponto de partida apropriado para seu controle personalizado.

A classe Control é 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 classe Page, que herda da classe Control e que manipulam solicitações de 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 das ameaças à segurança do 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 Como proteger 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

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

Propriedades

Nome	Description
Adapter	Obtém o adaptador específico do navegador para o controle.
AppRelativeTemplateSourceDirectory	Obtém ou define o diretório virtual relativo ao aplicativo do Page objeto ou UserControl que contém esse controle.
BindingContainer	Obtém o controle que contém a associação de dados desse controle.
ChildControlsCreated	Obtém um valor que indica se os controles filho do controle do servidor foram criados.
ClientID	Obtém a ID de controle para marcação HTML gerada por ASP.NET.
ClientIDMode	Obtém ou define o algoritmo usado para gerar o valor da ClientID propriedade.
ClientIDSeparator	Obtém um valor de caractere que representa o caractere separador usado na ClientID propriedade.
Context	Obtém o HttpContext objeto associado ao controle do servidor para a solicitação da Web atual.
Controls	Obtém um ControlCollection objeto que representa os controles filho para um controle de servidor especificado na hierarquia da interface do usuário.
DataItemContainer	Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementar IDataItemContainer.
DataKeysContainer	Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementar 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 do servidor persiste seu estado de exibição e o estado de exibição de todos os controles filho que ele contém, para o cliente solicitante.
Events	Obtém uma lista de representantes do manipulador de eventos para o controle. Esta propriedade é somente para leitura.
HasChildViewState	Obtém um valor que indica se os controles filho do controle do servidor atual têm configurações de estado de exibição salvas.
ID	Obtém ou define o identificador programático atribuído ao controle do servidor.
IdSeparator	Obtém o caractere usado para separar identificadores de controle.
IsChildControlStateCleared	Obtém um valor que indica se os controles contidos nesse controle têm estado de controle.
IsTrackingViewState	Obtém um valor que indica se o controle do servidor está salvando alterações em seu 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 no carregamento de seu estado de exibição ID em vez de índice.
NamingContainer	Obtém uma referência ao contêiner de nomenclatura do controle de servidor, que cria um namespace exclusivo para diferenciar entre controles de servidor com o mesmo ID valor de propriedade.
Page	Obtém uma referência à Page instância que contém o controle do servidor.
Parent	Obtém uma referência ao controle pai do controle do servidor na hierarquia de controle de página.
RenderingCompatibility	Obtém um valor que especifica a versão 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 renderizado em uma superfície de design.
SkinID	Obtém ou define a pele a ser aplicada ao controle.
TemplateControl	Obtém ou define uma referência ao modelo que contém esse controle.
TemplateSourceDirectory	Obtém o diretório virtual do Page ou UserControl que contém o controle de servidor atual.
UniqueID	Obtém o identificador exclusivo e hierarquicamente qualificado para o controle do servidor.
ValidateRequestMode	Obtém ou define um valor que indica se o controle verifica a entrada do cliente do navegador em busca de 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 StateBag objeto não diferencia maiúsculas de minúsculas.
ViewStateMode	Obtém ou define o modo de estado de exibição desse controle.
Visible	Obtém ou define um valor que indica se um controle de servidor é renderizado como interface do usuário na página.

Métodos

Nome	Description
AddedControl(Control, Int32)	Chamado depois que um controle filho é adicionado à Controls coleção do Control objeto.
AddParsedSubObject(Object)	Notifica o controle do servidor de que um elemento, XML ou HTML, foi analisado e adiciona o elemento ao objeto do controle do ControlCollection servidor.
ApplyStyleSheetSkin(Page)	Aplica as propriedades de estilo definidas na folha de estilos de página ao controle.
BeginRenderTracing(TextWriter, Object)	Inicia o rastreamento em tempo de design dos dados de renderização.
BuildProfileTree(String, Boolean)	Coleta informações sobre o controle do servidor e o Trace entrega na propriedade a ser exibida quando o rastreamento está habilitado para a página.
ClearCachedClientID()	Define o valor armazenado em ClientID cache como `null`.
ClearChildControlState()	Exclui as informações de estado de controle para os controles filho do controle do servidor.
ClearChildState()	Exclui as informações de estado de exibição e de estado de controle para todos os controles filho do controle do servidor.
ClearChildViewState()	Exclui as informações de estado de exibição para todos os controles filho do controle do servidor.
ClearEffectiveClientIDMode()	Define a ClientIDMode propriedade da instância de controle atual e de qualquer controle filho como Inherit.
CreateChildControls()	Chamado pela estrutura de página ASP.NET para notificar os controles de servidor que usam a implementação baseada em composição para criar quaisquer controles filho que eles contenham em preparação para postar de volta ou renderização.
CreateControlCollection()	Cria um novo ControlCollection objeto para manter os controles filho (literal e servidor) do controle do servidor.
DataBind()	Associa uma fonte de dados ao controle de servidor invocado e a todos os seus controles filho.
DataBind(Boolean)	Associa uma fonte de dados ao controle de servidor invocado e a todos os seus controles filho com uma opção para gerar o DataBinding evento.
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 de ser liberado da memória.
EndRenderTracing(TextWriter, Object)	Encerra o rastreamento em tempo de design dos dados de renderização.
EnsureChildControls()	Determina se o controle do servidor contém controles filho. Se isso não acontecer, 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, Int32)	Pesquisa o contêiner de nomenclatura atual para um controle de servidor com o especificado `id` e um inteiro, especificado no parâmetro, que `pathOffset` ajuda na pesquisa. Você não deve substituir essa versão do FindControl método.
FindControl(String)	Pesquisa o contêiner de nomenclatura atual para um controle de servidor com o parâmetro especificado `id` .
Focus()	Define o foco de entrada como um controle.
GetDesignModeState()	Obtém dados de tempo de design para um controle.
GetHashCode()	Serve como a função hash predefinida. (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 UniqueID propriedade do controle especificado.
HasControls()	Determina se o controle do servidor contém controles filho.
HasEvents()	Retorna um valor que indica se os eventos são registrados para o controle ou quaisquer controles filho.
IsLiteralContent()	Determina se o controle do servidor contém apenas conteúdo literal.
LoadControlState(Object)	Restaura informações de estado de controle de uma solicitação de página anterior que foi salva pelo SaveControlState() método.
LoadViewState(Object)	Restaura informações de estado de exibição de uma solicitação de página anterior que foi salva pelo SaveViewState() método.
MapPathSecure(String)	Recupera o caminho físico para o qual um caminho virtual, absoluto ou relativo, é mapeado.
MemberwiseClone()	Cria uma cópia superficial do Objectatual. (Herdado de Object)
OnBubbleEvent(Object, EventArgs)	Determina se o evento para o controle do servidor é passado para a hierarquia de controle do servidor de 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 todas as fontes do evento e suas informações ao pai do controle.
RemovedControl(Control)	Chamado depois que um controle filho é removido da Controls coleção do Control objeto.
Render(HtmlTextWriter)	Envia o conteúdo do controle do servidor para um objeto fornecido HtmlTextWriter , 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 fornecido HtmlTextWriter , que grava o conteúdo a ser renderizado no cliente.
RenderControl(HtmlTextWriter, ControlAdapter)	Gera conteúdo de controle de servidor para um objeto fornecido HtmlTextWriter usando um objeto fornecido ControlAdapter .
RenderControl(HtmlTextWriter)	O servidor de saída controla o conteúdo de um objeto fornecido HtmlTextWriter e armazena informações de rastreamento sobre o controle se o rastreamento estiver habilitado.
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 é utilizável no cliente solicitante.
SaveControlState()	Salva as alterações de estado do controle do servidor que ocorreram desde o momento em que a página foi postada de volta no servidor.
SaveViewState()	Salva as alterações de estado de exibição de controle do servidor que ocorreram desde o momento em que a página foi postada novamente no servidor.
SetDesignModeState(IDictionary)	Define dados de tempo de design para um controle.
SetRenderMethodDelegate(RenderMethod)	Atribui um representante do manipulador de eventos para renderizar o controle do servidor e seu conteúdo em seu controle pai.
SetTraceData(Object, Object, Object)	Define dados de rastreamento para rastreamento em tempo de design de dados de renderização, usando o objeto rastreado, a chave de dados de rastreamento e o valor dos dados de rastreamento.
SetTraceData(Object, Object)	Define dados de rastreamento para rastreamento em tempo de design de dados de renderização, usando a chave de dados de rastreamento e o valor dos dados de rastreamento.
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)
TrackViewState()	Causa o acompanhamento de alterações de estado de exibição no controle do servidor para que possam ser armazenadas no objeto do controle do StateBag servidor. Esse objeto é acessível por meio da ViewState propriedade.

Eventos

Nome	Description
DataBinding	Ocorre quando o controle do 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 do controle do servidor quando uma página ASP.NET é solicitada.
Init	Ocorre quando o controle do servidor é inicializado, que é a primeira etapa em seu ciclo de vida.
Load	Ocorre quando o controle do servidor é carregado no Page objeto.
PreRender	Ocorre depois que o Control objeto é carregado, mas antes da renderização.
Unload	Ocorre quando o controle do servidor é descarregado da memória.

Implantações explícitas de interface

Nome	Description
IControlBuilderAccessor.ControlBuilder	Para obter uma descrição deste membro, consulte ControlBuilder.
IControlDesignerAccessor.GetDesignModeState()	Para obter uma descrição deste membro, consulte GetDesignModeState().
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Para obter uma descrição deste membro, consulte SetDesignModeState(IDictionary).
IControlDesignerAccessor.SetOwnerControl(Control)	Para obter uma descrição deste membro, consulte SetOwnerControl(Control).
IControlDesignerAccessor.UserData	Para obter uma descrição deste membro, consulte UserData.
IDataBindingsAccessor.DataBindings	Para obter uma descrição deste membro, consulte DataBindings.
IDataBindingsAccessor.HasDataBindings	Para obter uma descrição deste membro, consulte HasDataBindings.
IExpressionsAccessor.Expressions	Para obter uma descrição deste membro, consulte Expressions.
IExpressionsAccessor.HasExpressions	Para obter uma descrição deste membro, consulte HasExpressions.
IParserAccessor.AddParsedSubObject(Object)	Para obter uma descrição deste membro, consulte AddParsedSubObject(Object).

Métodos de Extensão

Nome	Description
FindDataSourceControl(Control)	Retorna a fonte de dados associada ao controle de dados para o controle especificado.
FindFieldTemplate(Control, String)	Retorna o modelo de campo para a coluna especificada no contêiner de nomenclatura do controle especificado.
FindMetaTable(Control)	Retorna o objeto metatável para o controle de dados que contém.

Aplica-se a

Confira também

Comentários

Esta página foi útil?