Compartilhar via

Control Classe

  • Referência

Definição

Namespace:
System.Web.UI
Assembly:
System.Web.dll

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
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 classe Control. A classe InnerContent substitui o método Control.Render, 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 </H2> de fechamento na página dos 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 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 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 usuário, derive de WebControl ou qualquer controle no namespace System.Web.UI.WebControls 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 classe Control 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 dasde Ameaças à Segurança do Aplicativo Web,de Práticas Recomendadas da 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 caracterese 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 do navegador para o controle.
AppRelativeTemplateSourceDirectory

Obtém ou define o diretório virtual relativo ao aplicativo do objeto Page 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 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 do 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 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. Essa propriedade é somente 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 valor de propriedade ID.
Page

Obtém uma referência à instância de Page 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 do 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 objeto StateBag 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

AddedControl(Control, Int32)

Chamado depois que um controle filho é adicionado à coleção Controls do objeto Control.
AddParsedSubObject(Object)

Notifica o controle do servidor de que um elemento, XML ou HTML, foi analisado e adiciona o elemento ao objeto ControlCollection do controle do 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 entrega à propriedade Trace a ser exibida quando o rastreamento está habilitado para a página.
ClearCachedClientID()

Define o valor de ClientID armazenado em 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 propriedade ClientIDMode da instância de controle atual e de qualquer controle filho para 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 objeto ControlCollection 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 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 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 id especificado e um inteiro, especificados no parâmetro pathOffset, que auxilia na pesquisa. Você não deve substituir essa versão do método FindControl.
FindControl(String)

Pesquisa o contêiner de nomenclatura atual para um controle de servidor com o parâmetro id especificado.
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 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 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 método SaveControlState().
LoadViewState(Object)

Restaura informações de estado de exibição de uma solicitação de página anterior que foi salva pelo método SaveViewState().
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)

Gera o evento DataBinding.
OnInit(EventArgs)

Gera o evento Init.
OnLoad(EventArgs)

Gera o evento Load.
OnPreRender(EventArgs)

Gera o evento PreRender.
OnUnload(EventArgs)

Gera 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 coleção Controls do objeto Control.
Render(HtmlTextWriter)

Envia o conteúdo do controle do servidor para 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, ControlAdapter)

Gera conteúdo de controle de servidor para um objeto HtmlTextWriter fornecido usando um objeto ControlAdapter fornecido.
RenderControl(HtmlTextWriter)

O servidor de saída controla o conteúdo para um objeto HtmlTextWriter fornecido 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 StateBag do controle do servidor. Esse objeto é acessível por meio da propriedade ViewState.

Eventos

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 objeto Page.
PreRender

Ocorre depois que o objeto Control é carregado, mas antes da renderização.
Unload

Ocorre quando o controle do servidor é descarregado da memória.

Implantações explícitas de interface

IControlBuilderAccessor.ControlBuilder

Para obter uma descrição desse membro, consulte ControlBuilder.
IControlDesignerAccessor.GetDesignModeState()

Para obter uma descrição desse membro, consulte GetDesignModeState().
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Para obter uma descrição desse membro, consulte SetDesignModeState(IDictionary).
IControlDesignerAccessor.SetOwnerControl(Control)

Para obter uma descrição desse membro, consulte SetOwnerControl(Control).
IControlDesignerAccessor.UserData

Para obter uma descrição desse membro, consulte UserData.
IDataBindingsAccessor.DataBindings

Para obter uma descrição desse membro, consulte DataBindings.
IDataBindingsAccessor.HasDataBindings

Para obter uma descrição desse membro, consulte HasDataBindings.
IExpressionsAccessor.Expressions

Para obter uma descrição desse membro, consulte Expressions.
IExpressionsAccessor.HasExpressions

Para obter uma descrição desse membro, consulte HasExpressions.
IParserAccessor.AddParsedSubObject(Object)

Para obter uma descrição desse membro, consulte AddParsedSubObject(Object).

Métodos de Extensão

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