ImageButton Classe

Definição

Um controlo que apresenta uma imagem e responde a cliques do rato sobre a imagem.

public ref class ImageButton : System::Web::UI::WebControls::Image, System::Web::UI::IPostBackDataHandler, System::Web::UI::IPostBackEventHandler
public ref class ImageButton : System::Web::UI::WebControls::Image, System::Web::UI::IPostBackDataHandler, System::Web::UI::IPostBackEventHandler, System::Web::UI::WebControls::IButtonControl
public class ImageButton : System.Web.UI.WebControls.Image, System.Web.UI.IPostBackDataHandler, System.Web.UI.IPostBackEventHandler
public class ImageButton : System.Web.UI.WebControls.Image, System.Web.UI.IPostBackDataHandler, System.Web.UI.IPostBackEventHandler, System.Web.UI.WebControls.IButtonControl
type ImageButton = class
    inherit Image
    interface IPostBackDataHandler
    interface IPostBackEventHandler
type ImageButton = class
    inherit Image
    interface IPostBackDataHandler
    interface IPostBackEventHandler
    interface IButtonControl
Public Class ImageButton
Inherits Image
Implements IPostBackDataHandler, IPostBackEventHandler
Public Class ImageButton
Inherits Image
Implements IButtonControl, IPostBackDataHandler, IPostBackEventHandler
Herança
Implementações

Exemplos

O exemplo de código seguinte demonstra como criar um ImageButton controlo que mostra as coordenadas em que uma imagem é clicada.

Note

O exemplo de código seguinte utiliza o modelo de código de ficheiro único e pode não funcionar corretamente se for copiado diretamente para um ficheiro code-behind. Este exemplo de código deve ser copiado para um ficheiro de texto vazio que tenha uma extensão .aspx. Para mais informações sobre o modelo de código Web Forms, consulte ASP.NET Web Forms Page Code Model.

<%@ Page Language="C#" AutoEventWireup="True" %>
<!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>
    <title>ImageButton Sample</title>
<script language="C#" runat="server">

      void ImageButton_Click(object sender, ImageClickEventArgs e) 
      {
         Label1.Text = "You clicked the ImageButton control at the coordinates: (" + 
                       e.X.ToString() + ", " + e.Y.ToString() + ")";
      }

   </script>

</head>

<body>

   <form id="form1" runat="server">

      <h3>ImageButton Sample</h3>

      Click anywhere on the image.<br /><br />

      <asp:ImageButton id="imagebutton1" runat="server"
           AlternateText="ImageButton 1"
           ImageAlign="left"
           ImageUrl="images/pict.jpg"
           OnClick="ImageButton_Click"/>

      <br /><br />
    
      <asp:label id="Label1" runat="server"/>

   </form>

</body>
</html>
<%@ Page Language="VB" AutoEventWireup="True" %>
<!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>
    <title>ImageButton Sample</title>
<script language="VB" runat="server">

      Sub ImageButton_Click(sender As Object, e As ImageClickEventArgs) 
         Label1.Text = "You clicked the ImageButton control at the coordinates: (" & _ 
                       e.X.ToString() & ", " & e.Y.ToString() & ")"
      End Sub

   </script>

</head>

<body>

   <form id="form1" runat="server">

      <h3>ImageButton Sample</h3>

      Click anywhere on the image.<br /><br />

      <asp:ImageButton id="imagebutton1" runat="server"
           AlternateText="ImageButton 1"
           ImageAlign="left"
           ImageUrl="images/pict.jpg"
           OnClick="ImageButton_Click"/>

      <br /><br />
    
      <asp:label id="Label1" runat="server"/>

   </form>

</body>
</html>

Observações

Neste tópico:

Introduction

Use o ImageButton controlo para mostrar uma imagem que responda a cliques do rato.

Ambos os Click eventos e Command são ativados quando o ImageButton comando é carregado.

Podes usar o OnCommand gestor de eventos para fazer o ImageButton controlo comportar-se como um botão de Comando. Um nome de comando pode ser associado ao controlo usando a CommandName propriedade. Isto permite que múltiplos ImageButton controlos sejam colocados na mesma página Web. O valor da CommandName propriedade pode então ser identificado programaticamente no OnCommand gestor de eventos para determinar a ação apropriada a realizar quando cada ImageButton controlo é clicado. A CommandArgument propriedade também pode ser usada para passar informações adicionais sobre o comando, como especificar a ordem crescente.

Usar o controlo ImageButton é semelhante a usar o controlo ASP.NET Button. Para mais informações, consulte o Mapa de Conteúdos dos Controlos do Servidor Web de Botões. e a visão geral da classe para o Button controlo.

Determinar onde o utilizador clicou

Ao usar o OnClick gestor de eventos, pode determinar programaticamente as coordenadas onde a imagem é clicada. Pode então codificar uma resposta, com base nos valores das coordenadas. Note que a origem (0, 0) está localizada no canto superior esquerdo da imagem.

Controlos e Validação do ImageButton

Por defeito, a validação da página é realizada quando um ImageButton controlo é clicado. A validação de página determina se os controlos de entrada associados a um controlo de validação na página correspondem todas às regras de validação especificadas pelo controlo de validação. Para evitar que a validação da página ocorra, defina a CausesValidation propriedade para false.

Accessibility

Para informações sobre como configurar este controlo de modo a gerar marcação que cumpra os padrões de acessibilidade, consulte Acessibilidade em Visual Studio e ASP.NET e ASP.NET Controlos e Acessibilidade.

Sintaxe declarativa

<asp:ImageButton
    AccessKey="string"
    AlternateText="string"
    BackColor="color name|#dddddd"
    BorderColor="color name|#dddddd"
    BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
        Inset|Outset"
    BorderWidth="size"
    CausesValidation="True|False"
    CommandArgument="string"
    CommandName="string"
    CssClass="string"
    DescriptionUrl="uri"
    Enabled="True|False"
    EnableTheming="True|False"
    EnableViewState="True|False"
    ForeColor="color name|#dddddd"
    Height="size"
    ID="string"
    ImageAlign="NotSet|Left|Right|Baseline|Top|Middle|Bottom|
        AbsBottom|AbsMiddle|TextTop"
    ImageUrl="uri"
    OnClick="Click event handler"
    OnClientClick="string"
    OnCommand="Command event handler"
    OnDataBinding="DataBinding event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnLoad="Load event handler"
    OnPreRender="PreRender event handler"
    OnUnload="Unload event handler"
    PostBackUrl="uri"
    runat="server"
    SkinID="string"
    Style="string"
    TabIndex="integer"
    ToolTip="string"
    ValidationGroup="string"
    Visible="True|False"
    Width="size"
/>

Construtores

Name Description
ImageButton()

Inicializa uma nova instância da ImageButton classe.

Propriedades

Name Description
AccessKey

Obtém ou define a chave de acesso que permite navegar rapidamente até ao controlo do servidor Web.

(Herdado de WebControl)
Adapter

Recebe o adaptador específico do navegador para o controlo.

(Herdado de Control)
AlternateText

Recebe ou define o texto alternativo apresentado no Image controlo quando a imagem não está disponível. Os navegadores que suportam a funcionalidade ToolTips exibem este texto como uma ToolTip.

(Herdado de Image)
AppRelativeTemplateSourceDirectory

Obtém ou define o diretório virtual relativo à aplicação do Page objeto ou UserControl que contém este controlo.

(Herdado de Control)
Attributes

Obtém a coleção de atributos arbitrários (apenas para renderização) que não correspondem a propriedades no controlo.

(Herdado de WebControl)
BackColor

Obtém ou define a cor de fundo do controlo do servidor Web.

(Herdado de WebControl)
BindingContainer

Obtém o controlo que contém a ligação de dados desse controlo.

(Herdado de Control)
BorderColor

Obtém ou define a cor da borda do controlo Web.

(Herdado de WebControl)
BorderStyle

Obtém ou define o estilo de borda do controlo do servidor Web.

(Herdado de WebControl)
BorderWidth

Obtém ou define a largura da fronteira do controlo do servidor Web.

(Herdado de WebControl)
CausesValidation

Recebe ou define um valor que indica se a validação é realizada quando o ImageButton controlo é clicado.

ChildControlsCreated

Recebe um valor que indica se os controlos filhos do controlo do servidor foram criados.

(Herdado de Control)
ClientID

Obtém o ID de controlo para a marcação HTML gerada pelo ASP.NET.

(Herdado de Control)
ClientIDMode

Obtém ou define o algoritmo que é usado para gerar o valor da ClientID propriedade.

(Herdado de Control)
ClientIDSeparator

Obtém um valor de carácter que representa o carácter separador usado na ClientID propriedade.

(Herdado de Control)
CommandArgument

Obtém ou estabelece um argumento opcional que fornece informações adicionais sobre a CommandName propriedade.

CommandName

Recebe ou define o nome do comando associado ao ImageButton controlo.

Context

Obtém o controlo do HttpContext objeto associado ao servidor para o pedido Web atual.

(Herdado de Control)
Controls

Obtém um ControlCollection objeto que representa os controlos filhos de um servidor especificado na hierarquia da interface.

(Herdado de Control)
ControlStyle

Recebe o estilo do controlo do servidor Web. Esta propriedade é utilizada principalmente por promotores de controlo.

(Herdado de WebControl)
ControlStyleCreated

Recebe um valor que indica se um Style objeto foi criado para a ControlStyle propriedade. Esta propriedade é utilizada principalmente por promotores de controlo.

(Herdado de WebControl)
CssClass

Obtém ou define a classe Cascading Style Sheet (CSS) renderizada pelo controlo do servidor Web no cliente.

(Herdado de WebControl)
DataItemContainer

Obtém uma referência ao contentor de nomes se o contentor implementar IDataItemContainer.

(Herdado de Control)
DataKeysContainer

Obtém uma referência ao contentor de nomes se o contentor implementar IDataKeysControl.

(Herdado de Control)
DescriptionUrl

Obtém ou define a localização com uma descrição detalhada da imagem.

(Herdado de Image)
DesignMode

Obtém um valor que indica se um controlo está a ser usado numa superfície de projeto.

(Herdado de Control)
Enabled

Recebe ou define um valor que indica se pode ImageButton ser clicado para fazer uma publicação de volta ao servidor.

Enabled

Recebe ou define um valor que indica se o controlo está ativado.

(Herdado de Image)
EnableTheming

Recebe ou define um valor que indica se os temas se aplicam a este controlo.

(Herdado de WebControl)
EnableViewState

Recebe ou define um valor que indica se o controlo do servidor mantém o seu estado de visualização, e o estado de vista de quaisquer controlos filhos que contém, para o cliente solicitante.

(Herdado de Control)
Events

Obtém uma lista de delegados handler de eventos para o controlo. Esta propriedade é somente leitura.

(Herdado de Control)
Font

Obtém as propriedades da fonte do texto associado ao controlo.

(Herdado de Image)
ForeColor

Obtém ou define a cor do primeiro plano (tipicamente a cor do texto) do controlo do servidor Web.

(Herdado de WebControl)
GenerateEmptyAlternateText

Recebe ou define um valor que indica se o controlo gera um atributo de texto alternativo para um valor de string vazio.

HasAttributes

Recebe um valor que indica se o controlo tem atributos definidos.

(Herdado de WebControl)
HasChildViewState

Recebe um valor que indica se os controlos filhos do controlo atual do servidor têm alguma configuração de estado de visualização guardada.

(Herdado de Control)
Height

Obtém ou define a altura do controlo do servidor Web.

(Herdado de WebControl)
ID

Obtém ou define o identificador programático atribuído ao controlo do servidor.

(Herdado de Control)
IdSeparator

Faz com que o carácter seja usado para separar identificadores de controlo.

(Herdado de Control)
ImageAlign

Obtém ou define o alinhamento do Image controlo em relação a outros elementos da página Web.

(Herdado de Image)
ImageUrl

Obtém ou define o URL que fornece o caminho para uma imagem a ser exibida no Image controlo.

(Herdado de Image)
IsChildControlStateCleared

Obtém um valor que indica se os controlos contidos neste controlo têm estado de controlo.

(Herdado de Control)
IsEnabled

Recebe um valor que indica se o controlo está ativado.

(Herdado de WebControl)
IsTrackingViewState

Recebe um valor que indica se o controlo do servidor está a guardar alterações ao estado de visualização.

(Herdado de Control)
IsViewStateEnabled

Recebe um valor que indica se o estado de visualização está ativado para este controlo.

(Herdado de Control)
LoadViewStateByID

Recebe um valor que indica se o controlo participa no carregamento do seu estado de visualização em ID vez de index.

(Herdado de Control)
NamingContainer

Obtém uma referência ao contentor de nomes do controlo do servidor, que cria um namespace único para diferenciar controlos de servidor com o mesmo ID valor de propriedade.

(Herdado de Control)
OnClientClick

Recebe ou define o script do lado do cliente que é executado quando o evento de Click um ImageButton controlo é levantado.

Page

Obtém uma referência à Page instância que contém o controlo do servidor.

(Herdado de Control)
Parent

Obtém uma referência ao controlo pai do controlo do servidor na hierarquia de controlo de página.

(Herdado de Control)
PostBackUrl

Obtém ou define o URL da página para publicar a partir da página atual quando o ImageButton controlo é clicado.

RenderingCompatibility

Recebe um valor que especifica a versão ASP.NET com a qual o HTML renderizado será compatível.

(Herdado de Control)
Site

Obtém informação sobre o contentor que aloja o controlo atual quando renderizado numa superfície de design.

(Herdado de Control)
SkinID

Obtém ou fixa a pele para aplicar no controlo.

(Herdado de WebControl)
Style

Recebe uma coleção de atributos de texto que serão renderizados como um atributo de estilo na etiqueta externa do controlo do servidor Web.

(Herdado de WebControl)
SupportsDisabledAttribute

Obtém um valor que indica se o controlo deve definir o disabled atributo do elemento HTML renderizado como "desabilitado" quando a propriedade do IsEnabled controlo é false.

TabIndex

Obtém ou define o índice de tabulação do controlo do servidor Web.

(Herdado de WebControl)
TagKey

Obtém o HtmlTextWriterTag valor que corresponde ao ImageButton controlo.

TagName

Recebe o nome da etiqueta de controlo. Esta propriedade é utilizada principalmente por promotores de controlo.

(Herdado de WebControl)
TemplateControl

Recebe ou define uma referência ao template que contém esse controlo.

(Herdado de Control)
TemplateSourceDirectory

Obtém o diretório virtual do Page ou UserControl que contém o controlo atual do servidor.

(Herdado de Control)
Text

Obtém ou define o valor da ImageButton propriedade do AlternateText controlo.

ToolTip

Obtém ou define o texto exibido quando o ponteiro do rato paira sobre o controlo do servidor Web.

(Herdado de WebControl)
UniqueID

Obtém o identificador único e hierarquicamente qualificado para o controlo do servidor.

(Herdado de Control)
ValidateRequestMode

Recebe ou define um valor que indica se o controlo verifica a entrada do cliente do navegador para valores potencialmente perigosos.

(Herdado de Control)
ValidationGroup

Obtém ou define o grupo de controlos para os quais o controlo ImageButton causa validação quando é enviado de volta ao servidor.

ViewState

Obtém um dicionário de informação de estado que permite guardar e restaurar o estado de visualização de um controlo de servidor através de múltiplos pedidos para a mesma página.

(Herdado de Control)
ViewStateIgnoresCase

Obtém um valor que indica se o StateBag objeto é indistinto a maiúsculas e maiúsculas.

(Herdado de Control)
ViewStateMode

Obtém ou define o modo view-state deste controlo.

(Herdado de Control)
Visible

Recebe ou define um valor que indica se um controlo de servidor é renderizado como UI na página.

(Herdado de Control)
Width

Obtém ou define a largura do controlo do servidor Web.

(Herdado de WebControl)

Métodos

Name Description
AddAttributesToRender(HtmlTextWriter)

Adiciona os atributos de an ImageButton ao fluxo de saída para renderização no cliente.

AddedControl(Control, Int32)

Chamado após um controlo filho ser adicionado à Controls coleção do Control objeto.

(Herdado de Control)
AddParsedSubObject(Object)

Notifica o controlo do servidor que um elemento, seja XML ou HTML, foi analisado, e adiciona o elemento ao objeto do ControlCollection controlo do servidor.

(Herdado de Control)
ApplyStyle(Style)

Copia quaisquer elementos não em branco do estilo especificado para o controlo Web, sobrescrevendo quaisquer elementos de estilo existentes do controlo. Este método é usado principalmente por desenvolvedores de controlo.

(Herdado de WebControl)
ApplyStyleSheetSkin(Page)

Aplica as propriedades de estilo definidas na folha de estilo da página ao controlo.

(Herdado de Control)
BeginRenderTracing(TextWriter, Object)

Inicia o rastreio em tempo de design dos dados de renderização.

(Herdado de Control)
BuildProfileTree(String, Boolean)

Recolhe informações sobre o controlo do servidor e entrega-as à Trace propriedade para serem exibidas quando o rastreamento for ativado para a página.

(Herdado de Control)
ClearCachedClientID()

Define o valor em ClientID cache para null.

(Herdado de Control)
ClearChildControlState()

Apaga a informação de estado de controlo dos controlos filhos do controlo do servidor.

(Herdado de Control)
ClearChildState()

Apaga a informação de view-state e control-state de todos os controlos filhos do servidor.

(Herdado de Control)
ClearChildViewState()

Elimina a informação de estado de visualização de todos os controlos filhos do controlo do servidor.

(Herdado de Control)
ClearEffectiveClientIDMode()

Define a ClientIDMode propriedade da instância de controlo atual e de qualquer controlo filho para Inherit.

(Herdado de Control)
CopyBaseAttributes(WebControl)

Copia as propriedades não encapsuladas pelo Style objeto do controlo do servidor Web especificado para o controlo do servidor Web de onde este método é chamado. Este método é utilizado principalmente por reveladores de controlo.

(Herdado de WebControl)
CreateChildControls()

Chamada pelo framework de páginas ASP.NET para notificar os controlos de servidor que utilizam implementação baseada em composição para criar quaisquer controlos filhos que contenham em preparação para publicação ou renderização.

(Herdado de Control)
CreateControlCollection()

Cria um novo ControlCollection objeto para armazenar os controlos filhos (tanto literais como de servidor) do controlo do servidor.

(Herdado de Control)
CreateControlStyle()

Cria o objeto de estilo que é usado internamente pela WebControl classe para implementar todas as propriedades relacionadas com o estilo. Este método é utilizado principalmente por reveladores de controlo.

(Herdado de WebControl)
DataBind()

Vincula uma fonte de dados ao controlo do servidor invocado e a todos os seus controlos filhos.

(Herdado de Control)
DataBind(Boolean)

Vincula uma fonte de dados ao controlo do servidor invocado e a todos os seus controlos filhos com uma opção para elevar o DataBinding evento.

(Herdado de Control)
DataBindChildren()

Vincula uma fonte de dados aos controlos filhos do controlo do servidor.

(Herdado de Control)
Dispose()

Permite que o controlo do servidor realize a limpeza final antes de ser libertado da memória.

(Herdado de Control)
EndRenderTracing(TextWriter, Object)

Termina o rastreio de tempo de design dos dados de renderização.

(Herdado de Control)
EnsureChildControls()

Determina se o controlo do servidor contém controlos filhos. Se não o fizer, cria controlos filhos.

(Herdado de Control)
EnsureID()

Cria um identificador para controlos 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, Int32)

Pesquisa no contentor de nomenclatura atual um controlo de servidor com o especificado id e um inteiro, especificados no pathOffset parâmetro, o que auxilia na pesquisa. Não deve sobrepor-se a esta versão do FindControl método.

(Herdado de Control)
FindControl(String)

Procura no contentor de nomenclatura atual um controlo de servidor com o parâmetro especificado id .

(Herdado de Control)
Focus()

Define o foco de entrada num controlo.

(Herdado de Control)
GetDesignModeState()

Obtém dados de tempo de projeto para um controlo.

(Herdado de Control)
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetPostBackOptions()

Cria um PostBackOptions objeto que representa o ImageButton comportamento de postback do controlo.

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 o URL que corresponde a um conjunto de parâmetros de rota e a um nome de rota.

(Herdado de Control)
GetRouteUrl(String, RouteValueDictionary)

Obtém o URL que corresponde a um conjunto de parâmetros de rota e a um nome de rota.

(Herdado de Control)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
GetUniqueIDRelativeTo(Control)

Devolve a parte prefixada da UniqueID propriedade do controlo especificado.

(Herdado de Control)
HasControls()

Determina se o controlo do servidor contém algum controlo filho.

(Herdado de Control)
HasEvents()

Devolve um valor que indica se os eventos estão registados para o controlo ou para quaisquer controlos filhos.

(Herdado de Control)
IsLiteralContent()

Determina se o controlo do servidor contém apenas conteúdo literal.

(Herdado de Control)
LoadControlState(Object)

Restaura a informação do estado de controlo a partir de um pedido de página anterior que foi guardado pelo SaveControlState() método.

(Herdado de Control)
LoadPostData(String, NameValueCollection)

Os processos publicaram dados para o ImageButton controlo.

LoadViewState(Object)

Restaura a informação de estado de visualização de um pedido anterior que foi guardado com o SaveViewState() método.

(Herdado de WebControl)
MapPathSecure(String)

Recupera o caminho físico para o qual um caminho virtual, seja absoluto ou relativo, mapeia.

(Herdado de Control)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
MergeStyle(Style)

Copia quaisquer elementos não em branco do estilo especificado para o controlo Web, mas não sobrescreve quaisquer elementos de estilo existentes do controlo. Este método é utilizado principalmente por reveladores de controlo.

(Herdado de WebControl)
OnBubbleEvent(Object, EventArgs)

Determina se o evento para o controlo do servidor é passado para a hierarquia de controlo do servidor UI da página.

(Herdado de Control)
OnClick(ImageClickEventArgs)

Eleva o Click evento e permite-lhe gerir o Click evento diretamente.

OnCommand(CommandEventArgs)

Eleva o Command evento e permite-lhe gerir o Command evento diretamente.

OnDataBinding(EventArgs)

Eleva o DataBinding evento.

(Herdado de Control)
OnInit(EventArgs)

Eleva o Init evento.

(Herdado de Control)
OnLoad(EventArgs)

Eleva o Load evento.

(Herdado de Control)
OnPreRender(EventArgs)

Determina se a imagem foi clicada antes de ser renderizada no cliente.

OnUnload(EventArgs)

Eleva o Unload evento.

(Herdado de Control)
OpenFile(String)

Recebe um Stream usado para ler um ficheiro.

(Herdado de Control)
RaiseBubbleEvent(Object, EventArgs)

Atribui quaisquer fontes do evento e da sua informação ao pai do controlo.

(Herdado de Control)
RaisePostBackEvent(String)

Levanta eventos para o ImageButton controlo quando este é enviado de volta ao servidor.

RaisePostDataChangedEvent()

Notifica a aplicação ASP.NET que o estado do controlo ImageButton mudou.

RemovedControl(Control)

Chamado após um controlo filho ser removido da Controls coleção do Control objeto.

(Herdado de Control)
Render(HtmlTextWriter)

Renderiza o controlo para o escritor HTML especificado.

(Herdado de WebControl)
RenderBeginTag(HtmlTextWriter)

Renderiza a etiqueta de abertura HTML do controlo ao escritor especificado. Este método é utilizado principalmente por reveladores de controlo.

(Herdado de WebControl)
RenderChildren(HtmlTextWriter)

Exporta o conteúdo dos filhos de um controlo de servidor para um objeto fornecido HtmlTextWriter , que escreve o conteúdo a ser renderizado no cliente.

(Herdado de Control)
RenderContents(HtmlTextWriter)

Renderiza o conteúdo do controlo de imagem para o autor especificado.

(Herdado de Image)
RenderControl(HtmlTextWriter, ControlAdapter)

Fornece conteúdo de controlo do servidor para um objeto fornecido HtmlTextWriter usando um objeto fornecido ControlAdapter .

(Herdado de Control)
RenderControl(HtmlTextWriter)

Fornece conteúdo de controlo do servidor para um objeto fornecido HtmlTextWriter e armazena informação de rastreamento sobre o controlo se o rastreio estiver ativado.

(Herdado de Control)
RenderEndTag(HtmlTextWriter)

Renderiza a etiqueta HTML de fecho do controlo no escritor especificado. Este método é utilizado principalmente por reveladores de controlo.

(Herdado de WebControl)
ResolveAdapter()

Faz com que o adaptador de controlo seja responsável por renderizar o controlo especificado.

(Herdado de Control)
ResolveClientUrl(String)

Recebe um URL que pode ser usado pelo navegador.

(Herdado de Control)
ResolveUrl(String)

Converte uma URL numa que seja utilizável no cliente solicitante.

(Herdado de Control)
SaveControlState()

Guarda quaisquer alterações no estado de controlo do servidor que tenham ocorrido desde que a página foi publicada de volta no servidor.

(Herdado de Control)
SaveViewState()

Guarda qualquer estado que tenha sido modificado após o TrackViewState() método ter sido invocado.

(Herdado de WebControl)
SetDesignModeState(IDictionary)

Define dados em tempo de projeto para um controlo.

(Herdado de Control)
SetRenderMethodDelegate(RenderMethod)

Atribui um delegado handler de eventos para renderizar o controlo do servidor e o seu conteúdo no controlo pai.

(Herdado de Control)
SetTraceData(Object, Object, Object)

Define os dados de rastreio para o rastreio em tempo de design dos dados de renderização, usando o objeto rastreado, a chave de dados de traço e o valor dos dados de traço.

(Herdado de Control)
SetTraceData(Object, Object)

Define os dados de rastreio para o rastreio em tempo de design dos dados de renderização, usando a chave de dados de traço e o valor dos dados de traço.

(Herdado de Control)
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)
TrackViewState()

Faz com que o controlo acompanhe alterações ao estado de visualização para que possam ser armazenadas na propriedade do ViewState objeto.

(Herdado de WebControl)

evento

Name Description
Click

Ocorre quando é clicado ImageButton .

Command

Ocorre quando é clicado ImageButton .

DataBinding

Ocorre quando o controlo do servidor se liga a uma fonte de dados.

(Herdado de Control)
Disposed

Ocorre quando um controlo de servidor é libertado da memória, que é a última etapa do ciclo de vida do controlo do servidor quando uma página ASP.NET é solicitada.

(Herdado de Control)
Init

Ocorre quando o controlo do servidor é inicializado, que é o primeiro passo no seu ciclo de vida.

(Herdado de Control)
Load

Ocorre quando o controlo do servidor é carregado no Page objeto.

(Herdado de Control)
PreRender

Ocorre depois do carregamento do Control objeto, mas antes da renderização.

(Herdado de Control)
Unload

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

(Herdado de Control)

Implementações de Interface Explícita

Name Description
IAttributeAccessor.GetAttribute(String)

Recebe um atributo do controlo Web com o nome especificado.

(Herdado de WebControl)
IAttributeAccessor.SetAttribute(String, String)

Define um atributo do controlo Web ao nome e valor especificados.

(Herdado de WebControl)
IButtonControl.Click

Para uma descrição deste membro, veja o Click evento.

IButtonControl.Text

Para uma descrição deste elemento, veja Text.

IControlBuilderAccessor.ControlBuilder

Para uma descrição deste elemento, veja ControlBuilder.

(Herdado de Control)
IControlDesignerAccessor.GetDesignModeState()

Para uma descrição deste elemento, veja GetDesignModeState().

(Herdado de Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Para uma descrição deste elemento, veja SetDesignModeState(IDictionary).

(Herdado de Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Para uma descrição deste elemento, veja SetOwnerControl(Control).

(Herdado de Control)
IControlDesignerAccessor.UserData

Para uma descrição deste elemento, veja UserData.

(Herdado de Control)
IDataBindingsAccessor.DataBindings

Para uma descrição deste elemento, veja DataBindings.

(Herdado de Control)
IDataBindingsAccessor.HasDataBindings

Para uma descrição deste elemento, veja HasDataBindings.

(Herdado de Control)
IExpressionsAccessor.Expressions

Para uma descrição deste elemento, veja Expressions.

(Herdado de Control)
IExpressionsAccessor.HasExpressions

Para uma descrição deste elemento, veja HasExpressions.

(Herdado de Control)
IParserAccessor.AddParsedSubObject(Object)

Para uma descrição deste elemento, veja AddParsedSubObject(Object).

(Herdado de Control)
IPostBackDataHandler.LoadPostData(String, NameValueCollection)

Para uma descrição deste elemento, veja LoadPostData(String, NameValueCollection).

IPostBackDataHandler.RaisePostDataChangedEvent()

Para uma descrição deste elemento, veja RaisePostDataChangedEvent().

IPostBackEventHandler.RaisePostBackEvent(String)

Para uma descrição deste elemento, veja RaisePostBackEvent(String).

Métodos da Extensão

Name Description
FindDataSourceControl(Control)

Devolve a fonte de dados associada ao controlo de dados para o controlo especificado.

FindFieldTemplate(Control, String)

Devolve o modelo de campo para a coluna especificada no contentor de nomenclatura do controlo especificado.

FindMetaTable(Control)

Devolve o objeto metatable para o controlo de dados que contém.

Aplica-se a

Ver também