Control Classe

Definição

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 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 /H2> de fechamento <na página 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 quando desenvolve 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 tenha uma interface do usuário ou combine 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 ou WebControl qualquer controle no System.Web.UI.WebControls namespace que forneça um ponto de partida apropriado para seu 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 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 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 null.

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 id especificado.

FindControl(String, Int32)

Procura o contêiner de nomenclatura atual para um controle de servidor com o id especificado e um inteiro especificado no parâmetro pathOffset, que auxilia na pesquisa. Você não deve substituir esta versão do método FindControl.

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

IControlBuilderAccessor.ControlBuilder

Para obter uma descrição desse membro, confira ControlBuilder.

IControlDesignerAccessor.GetDesignModeState()

Para obter uma descrição desse membro, confira GetDesignModeState().

IControlDesignerAccessor.SetDesignModeState(IDictionary)

Para obter uma descrição desse membro, confira SetDesignModeState(IDictionary).

IControlDesignerAccessor.SetOwnerControl(Control)

Para obter uma descrição desse membro, confira SetOwnerControl(Control).

IControlDesignerAccessor.UserData

Para obter uma descrição desse membro, confira UserData.

IDataBindingsAccessor.DataBindings

Para obter uma descrição desse membro, confira DataBindings.

IDataBindingsAccessor.HasDataBindings

Para obter uma descrição desse membro, confira HasDataBindings.

IExpressionsAccessor.Expressions

Para obter uma descrição desse membro, confira Expressions.

IExpressionsAccessor.HasExpressions

Para obter uma descrição desse membro, confira HasExpressions.

IParserAccessor.AddParsedSubObject(Object)

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

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