ImageButton Classe

Definição

Um controle que exibe uma imagem e responde aos cliques do mouse na imagem.A control that displays an image and responds to mouse clicks on the image.

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

Um projeto de site do Visual Studio com código-fonte está disponível para acompanhar este tópico: Download.A Visual Studio Web site project with source code is available to accompany this topic: Download.

O exemplo de código a seguir demonstra como criar um ImageButton controle que exibe as coordenadas nas quais uma imagem é clicada.The following code example demonstrates how to create an ImageButton control that displays the coordinates at which an image is clicked.

Observação

O exemplo de código a seguir usa o modelo de código de arquivo único e pode não funcionar corretamente se copiado diretamente para um arquivo code-behind.The following code sample uses the single-file code model and may not work correctly if copied directly into a code-behind file. Este exemplo de código deve ser copiado em um arquivo de texto vazio que tenha uma extensão. aspx.This code sample must be copied into an empty text file that has an .aspx extension. Para obter mais informações sobre o modelo de código Web Forms, consulte modelo de código de página do ASP.NET Web Forms.For more information on the Web Forms code model, see 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>

Comentários

Neste tópico:In this topic:

IntroduçãoIntroduction

Use o ImageButton controle para exibir uma imagem que responde a cliques do mouse.Use the ImageButton control to display an image that responds to mouse clicks.

Os Click eventos e Command são gerados quando o ImageButton controle é clicado.Both the Click and Command events are raised when the ImageButton control is clicked.

Você pode usar o OnCommand manipulador de eventos para fazer com que o ImageButton controle se comporte como um botão de comando.You can use the OnCommand event handler to make the ImageButton control behave like a Command button. Um nome de comando pode ser associado ao controle usando a CommandName propriedade.A command name can be associated with the control by using the CommandName property. Isso permite que vários ImageButton controles sejam colocados na mesma página da Web.This allows multiple ImageButton controls to be placed on the same Web page. O valor da CommandName propriedade pode então ser identificado de forma programática no OnCommand manipulador de eventos para determinar a ação apropriada a ser executada quando cada ImageButton controle é clicado.The value of the CommandName property can then be programmatically identified in the OnCommand event handler to determine the appropriate action to perform when each ImageButton control is clicked. A CommandArgument propriedade também pode ser usada para passar informações adicionais sobre o comando, como especificar ordem crescente.The CommandArgument property can also be used to pass additional information about the command, such as specifying ascending order.

O uso do ImageButton controle é semelhante ao uso do Button controle ASP.net.Using the ImageButton control is similar to using the ASP.NET Button control. Para obter mais informações, consulte o botão controles do servidor Web de botões mapa de conteúdo.For more information, see Button Web Server Controls Content Map. e a visão geral da classe para o Button controle.and the class overview for the Button control.

Determinando onde o usuário clicouDetermining Where the User Clicked

Usando o OnClick manipulador de eventos, você pode determinar programaticamente as coordenadas nas quais a imagem é clicada.By using the OnClick event handler, you can programmatically determine the coordinates where the image is clicked. Em seguida, você pode codificar uma resposta com base nos valores das coordenadas.You can then code a response, based on the values of the coordinates. Observe que a origem (0, 0) está localizada no canto superior esquerdo da imagem.Note that the origin (0, 0) is located at the upper left corner of the image.

Validação e controles ImageButtonImageButton Controls and Validation

Por padrão, a validação de página é executada quando um ImageButton controle é clicado.By default, page validation is performed when an ImageButton control is clicked. A validação de página determina se os controles de entrada associados a um controle de validação na página todas passam as regras de validação especificadas pelo controle de validação.Page validation determines whether the input controls associated with a validation control on the page all pass the validation rules specified by the validation control. Para impedir que a validação de página ocorra, defina a CausesValidation propriedade como false .To prevent page validation from occurring, set the CausesValidation property to false.

AcessibilidadeAccessibility

Para obter informações sobre como configurar esse controle para que ele gere marcação que esteja de acordo com os padrões de acessibilidade, consulte acessibilidade no Visual Studio e controles e acessibilidadeASP.net e ASP.net.For information about how to configure this control so that it generates markup that conforms to accessibility standards, see Accessibility in Visual Studio and ASP.NET and ASP.NET Controls and Accessibility.

Sintaxe declarativaDeclarative Syntax

<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

ImageButton()

Inicializa uma nova instância da classe ImageButton.Initializes a new instance of the ImageButton class.

Propriedades

AccessKey

Obtém ou define a tecla de acesso que permite navegar rapidamente para o controle do servidor Web.Gets or sets the access key that allows you to quickly navigate to the Web server control.

(Herdado de WebControl)
Adapter

Obtém o adaptador específico de navegador para o controle.Gets the browser-specific adapter for the control.

(Herdado de Control)
AlternateText

Obtém ou define o texto alternativo exibido no controle de Image quando a imagem está indisponível.Gets or sets the alternate text displayed in the Image control when the image is unavailable. Navegadores que dão suporte ao recurso de dicas de ferramentas exibem esse texto como uma dica de ferramenta.Browsers that support the ToolTips feature display this text as a ToolTip.

(Herdado de Image)
AppRelativeTemplateSourceDirectory

Obtém ou define o diretório virtual relativo de aplicativo do objeto Page ou UserControl que contém este controle.Gets or sets the application-relative virtual directory of the Page or UserControl object that contains this control.

(Herdado de Control)
Attributes

Obtém a coleção de atributos arbitrários (somente para renderização) que não correspondem às propriedades do controle.Gets the collection of arbitrary attributes (for rendering only) that do not correspond to properties on the control.

(Herdado de WebControl)
BackColor

Obtém ou define a cor da tela de fundo do controle do servidor Web.Gets or sets the background color of the Web server control.

(Herdado de WebControl)
BindingContainer

Obtém o controle que contém a vinculação de dados desse controle.Gets the control that contains this control's data binding.

(Herdado de Control)
BorderColor

Obtém ou define a cor da borda do controle Web.Gets or sets the border color of the Web control.

(Herdado de WebControl)
BorderStyle

Obtém ou define o estilo de borda do controle de servidor Web.Gets or sets the border style of the Web server control.

(Herdado de WebControl)
BorderWidth

Obtém ou define a largura da borda do controle de servidor Web.Gets or sets the border width of the Web server control.

(Herdado de WebControl)
CausesValidation

Obtém ou define um valor que indica se a validação é executada quando o controle ImageButton é acionado.Gets or sets a value indicating whether validation is performed when the ImageButton control is clicked.

ChildControlsCreated

Obtém um valor que indica se os controles filho do controle de servidor foram criados.Gets a value that indicates whether the server control's child controls have been created.

(Herdado de Control)
ClientID

Obtém a ID de controle de marcação HTML gerada pelo ASP.NET.Gets the control ID for HTML markup that is generated by ASP.NET.

(Herdado de Control)
ClientIDMode

Obtém ou define o algoritmo usado para gerar o valor da propriedade ClientID.Gets or sets the algorithm that is used to generate the value of the ClientID property.

(Herdado de Control)
ClientIDSeparator

Obtém um valor de caractere que representa o caractere separador usado na propriedade ClientID.Gets a character value representing the separator character used in the ClientID property.

(Herdado de Control)
CommandArgument

Obtém ou define um argumento opcional que fornece informações adicionais sobre a propriedade CommandName.Gets or sets an optional argument that provides additional information about the CommandName property.

CommandName

Obtém ou define o nome de comando associado ao controle ImageButton.Gets or sets the command name associated with the ImageButton control.

Context

Obtém o objeto HttpContext associado ao controle de servidor para a solicitação da Web atual.Gets the HttpContext object associated with the server control for the current Web request.

(Herdado de Control)
Controls

Obtém um objeto ControlCollection que representa os controles filho para um controle de servidor especificado na hierarquia de interface do usuário.Gets a ControlCollection object that represents the child controls for a specified server control in the UI hierarchy.

(Herdado de Control)
ControlStyle

Obtém o estilo de um controle de servidor Web.Gets the style of the Web server control. Essa propriedade é usada principalmente por desenvolvedores de controle.This property is used primarily by control developers.

(Herdado de WebControl)
ControlStyleCreated

Obtém um valor que indica se um objeto Style foi criado para a propriedade ControlStyle.Gets a value indicating whether a Style object has been created for the ControlStyle property. Essa propriedade é usada principalmente por desenvolvedores de controle.This property is primarily used by control developers.

(Herdado de WebControl)
CssClass

Obtém ou define a classe CSS (Folha de Estilos em Cascata) renderizada pelo controle do servidor Web no cliente.Gets or sets the Cascading Style Sheet (CSS) class rendered by the Web server control on the client.

(Herdado de WebControl)
DataItemContainer

Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementa o IDataItemContainer.Gets a reference to the naming container if the naming container implements IDataItemContainer.

(Herdado de Control)
DataKeysContainer

Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementa o IDataKeysControl.Gets a reference to the naming container if the naming container implements IDataKeysControl.

(Herdado de Control)
DescriptionUrl

Obtém ou define o local para uma descrição detalhada da imagem.Gets or sets the location to a detailed description for the image.

(Herdado de Image)
DesignMode

Obtém um valor que indica se um controle está sendo usado em uma superfície de design.Gets a value indicating whether a control is being used on a design surface.

(Herdado de Control)
Enabled

Obtém ou define um valor que indica se o ImageButton pode ser clicado para executar uma postagem para o servidor.Gets or sets a value indicating whether the ImageButton can be clicked to perform a post back to the server.

Enabled

Obtém ou define um valor que indica se o controle está habilitado.Gets or sets a value indicating whether the control is enabled.

(Herdado de Image)
EnableTheming

Obtém ou define um valor que indica se os temas se aplicam a esse controle.Gets or sets a value indicating whether themes apply to this control.

(Herdado de WebControl)
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.Gets or sets a value indicating whether the server control persists its view state, and the view state of any child controls it contains, to the requesting client.

(Herdado de Control)
Events

Obtém uma lista de delegados de manipulador de eventos para o controle.Gets a list of event handler delegates for the control. Essa propriedade é somente leitura.This property is read-only.

(Herdado de Control)
Font

Obtém as propriedades de fonte para o texto associado ao controle.Gets the font properties for the text associated with the control.

(Herdado de Image)
ForeColor

Obtém ou define a cor de primeiro plano (normalmente a cor do texto) do controle de servidor Web.Gets or sets the foreground color (typically the color of the text) of the Web server control.

(Herdado de WebControl)
GenerateEmptyAlternateText

Obtém ou define um valor que indica se o controle gera um atributo de texto alternativo para um valor de cadeia de caracteres vazia.Gets or sets a value indicating whether the control generates an alternate-text attribute for an empty string value.

GenerateEmptyAlternateText

Obtém ou define um valor que indica se o controle gera um atributo de texto alternativo para um valor de cadeia de caracteres vazia.Gets or sets a value indicating whether the control generates an alternate text attribute for an empty string value.

(Herdado de Image)
HasAttributes

Obtém um valor que indica se o controle tem atributos definidos.Gets a value indicating whether the control has attributes set.

(Herdado de WebControl)
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.Gets a value indicating whether the current server control's child controls have any saved view-state settings.

(Herdado de Control)
Height

Obtém ou define a altura do controle do servidor Web.Gets or sets the height of the Web server control.

(Herdado de WebControl)
ID

Obtém ou define o identificador programático atribuído ao controle de servidor.Gets or sets the programmatic identifier assigned to the server control.

(Herdado de Control)
IdSeparator

Obtém o caractere usado para separar identificadores de controle.Gets the character used to separate control identifiers.

(Herdado de Control)
ImageAlign

Obtém ou define o alinhamento do controle Image em relação a outros elementos na página da Web.Gets or sets the alignment of the Image control in relation to other elements on the Web page.

(Herdado de Image)
ImageUrl

Obtém ou define a URL que fornece o caminho a uma imagem para exibir o controle Image.Gets or sets the URL that provides the path to an image to display in the Image control.

(Herdado de Image)
IsChildControlStateCleared

Obtém um valor que indica se os controles contidos dentro deste controle têm estado de controle.Gets a value indicating whether controls contained within this control have control state.

(Herdado de Control)
IsEnabled

Obtém um valor que indica se o controle está habilitado.Gets a value indicating whether the control is enabled.

(Herdado de WebControl)
IsTrackingViewState

Obtém um valor que indica se o controle de servidor está salvando alterações no estado de exibição.Gets a value that indicates whether the server control is saving changes to its view state.

(Herdado de Control)
IsViewStateEnabled

Obtém um valor que indica se o estado de exibição está habilitado para esse controle.Gets a value indicating whether view state is enabled for this control.

(Herdado de Control)
LoadViewStateByID

Obtém um valor que indica se o controle participa do carregamento do estado de exibição por ID em vez do índice.Gets a value indicating whether the control participates in loading its view state by ID instead of index.

(Herdado de Control)
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.Gets a reference to the server control's naming container, which creates a unique namespace for differentiating between server controls with the same ID property value.

(Herdado de Control)
OnClientClick

Obtém ou define o script do lado do cliente executado quando um evento Click do controle ImageButton é acionado.Gets or sets the client-side script that executes when an ImageButton control's Click event is raised.

Page

Obtém uma referência para a instância Page que contém o controle de servidor.Gets a reference to the Page instance that contains the server control.

(Herdado de Control)
Parent

Obtém uma referência ao controle pai do controle de servidor na hierarquia de controle da página.Gets a reference to the server control's parent control in the page control hierarchy.

(Herdado de Control)
PostBackUrl

Obtém ou define a URL da página que será usada para postagem da página atual quando um usuário clicar no controle ImageButton.Gets or sets the URL of the page to post to from the current page when the ImageButton control is clicked.

RenderingCompatibility

Obtém um valor que especifica a versão do ASP.NET com a qual o HTML renderizado será compatível.Gets a value that specifies the ASP.NET version that rendered HTML will be compatible with.

(Herdado de Control)
Site

Obtém informações sobre o contêiner que hospeda o controle atual quando renderizados em uma superfície de design.Gets information about the container that hosts the current control when rendered on a design surface.

(Herdado de Control)
SkinID

Obtém ou define a capa a ser aplicada ao controle.Gets or sets the skin to apply to the control.

(Herdado de WebControl)
Style

Obtém uma coleção de atributos de texto que serão renderizados como um atributo de estilo na marca externa do controle de servidor Web.Gets a collection of text attributes that will be rendered as a style attribute on the outer tag of the Web server control.

(Herdado de WebControl)
SupportsDisabledAttribute

Obtém um valor que indica se o controle deve definir o atributo disabled do elemento HTML renderizado para "desabilitado" quando a propriedade do controle IsEnabled é false.Gets a value that indicates whether the control should set the disabled attribute of the rendered HTML element to "disabled" when the control's IsEnabled property is false.

SupportsDisabledAttribute

Obtém um valor que indica se o controle deve definir o atributo disabled do elemento HTML renderizado para "desabilitado" quando a propriedade do controle IsEnabled é false.Gets a value that indicates whether the control should set the disabled attribute of the rendered HTML element to "disabled" when the control's IsEnabled property is false.

(Herdado de Image)
TabIndex

Obtém ou define o índice de tabulação do controle do servidor Web.Gets or sets the tab index of the Web server control.

(Herdado de WebControl)
TagKey

Obtém o valor HtmlTextWriterTag que corresponde ao controle ImageButton.Gets the HtmlTextWriterTag value that corresponds to the ImageButton control.

TagName

Obtém o nome da marca de controle.Gets the name of the control tag. Essa propriedade é usada principalmente por desenvolvedores de controle.This property is used primarily by control developers.

(Herdado de WebControl)
TemplateControl

Obtém ou define uma referência ao modelo que contém este controle.Gets or sets a reference to the template that contains this control.

(Herdado de Control)
TemplateSourceDirectory

Obtém o diretório virtual do Page ou UserControl que contém o controle do servidor atual.Gets the virtual directory of the Page or UserControl that contains the current server control.

(Herdado de Control)
Text

Obtém ou define o valor de ImageButton da propriedade AlternateText do controle.Gets or sets the value of the ImageButton control's AlternateText property.

ToolTip

Obtém ou define o texto exibido quando o ponteiro do mouse passa sobre o controle de servidor Web.Gets or sets the text displayed when the mouse pointer hovers over the Web server control.

(Herdado de WebControl)
UniqueID

Obtém o identificador exclusivo, qualificado segundo a hierarquia, para o controle de servidor.Gets the unique, hierarchically qualified identifier for the server control.

(Herdado de Control)
ValidateRequestMode

Obtém ou define um valor que indica se o controle verifica a entrada do cliente do navegador para valores potencialmente perigosos.Gets or sets a value that indicates whether the control checks client input from the browser for potentially dangerous values.

(Herdado de Control)
ValidationGroup

Obtém ou define o grupo de controles para os quais o controle ImageButton aciona a validação quando posta de volta no servidor.Gets or sets the group of controls for which the ImageButton control causes validation when it posts back to the server.

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.Gets a dictionary of state information that allows you to save and restore the view state of a server control across multiple requests for the same page.

(Herdado de Control)
ViewStateIgnoresCase

Obtém um valor que indica se o objeto StateBag não diferencia maiúsculas de minúsculas.Gets a value that indicates whether the StateBag object is case-insensitive.

(Herdado de Control)
ViewStateMode

Obtém ou define o modo de estado de exibição deste controle.Gets or sets the view-state mode of this control.

(Herdado de Control)
Visible

Obtém ou define um valor que indica se um controle de servidor é renderizado como uma interface do usuário na página.Gets or sets a value that indicates whether a server control is rendered as UI on the page.

(Herdado de Control)
Width

Obtém ou define a largura do controle de servidor Web.Gets or sets the width of the Web server control.

(Herdado de WebControl)

Métodos

AddAttributesToRender(HtmlTextWriter)

Adiciona os atributos de um ImageButton ao fluxo de saída para renderização no cliente.Adds the attributes of an ImageButton to the output stream for rendering on the client.

AddedControl(Control, Int32)

Chamado após um controle filho ser adicionado à coleção Controls do objeto Control.Called after a child control is added to the Controls collection of the Control object.

(Herdado de 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.Notifies the server control that an element, either XML or HTML, was parsed, and adds the element to the server control's ControlCollection object.

(Herdado de Control)
ApplyStyle(Style)

Copia os elementos não vazios do estilo especificado para o controle da Web, substituindo os elementos de estilo existentes no controle.Copies any nonblank elements of the specified style to the Web control, overwriting any existing style elements of the control. Esse método é usado principalmente por desenvolvedores de controles.This method is primarily used by control developers.

(Herdado de WebControl)
ApplyStyleSheetSkin(Page)

Aplica as propriedades de estilo definidas na folha de estilos da página ao controle.Applies the style properties defined in the page style sheet to the control.

(Herdado de Control)
BeginRenderTracing(TextWriter, Object)

Inicia o rastreamento de tempo de design de dados de renderização.Begins design-time tracing of rendering data.

(Herdado de Control)
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.Gathers information about the server control and delivers it to the Trace property to be displayed when tracing is enabled for the page.

(Herdado de Control)
ClearCachedClientID()

Define o valor ClientID armazenado em cache como null.Sets the cached ClientID value to null.

(Herdado de Control)
ClearChildControlState()

Exclui as informações de estado de controle para os controles filho do controle de servidor.Deletes the control-state information for the server control's child controls.

(Herdado de Control)
ClearChildState()

Exclui as informações de estado de exibição e de estado de controle para todos os controles filho do controle de servidor.Deletes the view-state and control-state information for all the server control's child controls.

(Herdado de Control)
ClearChildViewState()

Exclui as informações de estado de exibição para todos os controles filho do controle de servidor.Deletes the view-state information for all the server control's child controls.

(Herdado de Control)
ClearEffectiveClientIDMode()

Define a propriedade ClientIDMode da instância de controle atual e de quaisquer controles filho para Inherit.Sets the ClientIDMode property of the current control instance and of any child controls to Inherit.

(Herdado de Control)
CopyBaseAttributes(WebControl)

Copia as propriedades que não são encapsuladas pelo objeto Style de controle do servidor Web especificado ao controle de servidor Web do qual este método é chamado.Copies the properties not encapsulated by the Style object from the specified Web server control to the Web server control that this method is called from. Esse método é usado principalmente por desenvolvedores de controle.This method is used primarily by control developers.

(Herdado de WebControl)
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.Called by the ASP.NET page framework to notify server controls that use composition-based implementation to create any child controls they contain in preparation for posting back or rendering.

(Herdado de Control)
CreateControlCollection()

Cria um novo objeto ControlCollection para manter os controles filho (literal e servidor) do controle do servidor.Creates a new ControlCollection object to hold the child controls (both literal and server) of the server control.

(Herdado de Control)
CreateControlStyle()

Cria o objeto de estilo que é usado internamente pela classe WebControl para implementar todas as propriedades relacionadas a estilo.Creates the style object that is used internally by the WebControl class to implement all style related properties. Esse método é usado principalmente por desenvolvedores de controle.This method is used primarily by control developers.

(Herdado de WebControl)
DataBind()

Associa uma fonte de dados ao controle de servidor chamado e a todos os seus controles filho.Binds a data source to the invoked server control and all its child controls.

(Herdado de Control)
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.Binds a data source to the invoked server control and all its child controls with an option to raise the DataBinding event.

(Herdado de Control)
DataBindChildren()

Associa uma fonte de dados aos controles filho do controle do servidor.Binds a data source to the server control's child controls.

(Herdado de Control)
Dispose()

Permite que um controle de servidor execute a limpeza final antes do lançamento da memória.Enables a server control to perform final clean up before it is released from memory.

(Herdado de Control)
EndRenderTracing(TextWriter, Object)

Encerra o rastreamento de tempo de design de dados de renderização.Ends design-time tracing of rendering data.

(Herdado de Control)
EnsureChildControls()

Determinará se o controle de servidor contiver controles filho.Determines whether the server control contains child controls. Se ele não contiver, ele criará controles filho.If it does not, it creates child controls.

(Herdado de Control)
EnsureID()

Cria um identificador para controles que não têm um identificador atribuído.Creates an identifier for controls that do not have an identifier assigned.

(Herdado de Control)
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Herdado de Object)
FindControl(String)

Procura o atual contêiner de nomenclatura de um controle de servidor com o parâmetro id especificado.Searches the current naming container for a server control with the specified id parameter.

(Herdado de Control)
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.Searches the current naming container for a server control with the specified id and an integer, specified in the pathOffset parameter, which aids in the search. Você não deve substituir esta versão do método FindControl.You should not override this version of the FindControl method.

(Herdado de Control)
Focus()

Define o foco de entrada para um controle.Sets input focus to a control.

(Herdado de Control)
GetDesignModeState()

Obtém os dados de tempo de design para um controle.Gets design-time data for a control.

(Herdado de Control)
GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Herdado de Object)
GetPostBackOptions()

Cria um objeto PostBackOptions que representa o comportamento de postback do controle ImageButton.Creates a PostBackOptions object that represents the ImageButton control's postback behavior.

GetRouteUrl(Object)

Obtém a URL que corresponde a um conjunto de parâmetros de rota.Gets the URL that corresponds to a set of route parameters.

(Herdado de Control)
GetRouteUrl(RouteValueDictionary)

Obtém a URL que corresponde a um conjunto de parâmetros de rota.Gets the URL that corresponds to a set of route parameters.

(Herdado de Control)
GetRouteUrl(String, Object)

Obtém a URL que corresponde a um conjunto de parâmetros de rota e um nome de rota.Gets the URL that corresponds to a set of route parameters and a route name.

(Herdado de Control)
GetRouteUrl(String, RouteValueDictionary)

Obtém a URL que corresponde a um conjunto de parâmetros de rota e um nome de rota.Gets the URL that corresponds to a set of route parameters and a route name.

(Herdado de Control)
GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
GetUniqueIDRelativeTo(Control)

Retorna a parte prefixada da propriedade UniqueID do controle especificado.Returns the prefixed portion of the UniqueID property of the specified control.

(Herdado de Control)
HasControls()

Determina se o controle de servidor contém algum controle filho.Determines if the server control contains any child controls.

(Herdado de Control)
HasEvents()

Retorna um valor que indica se os eventos são registrados para o controle ou qualquer controle filho.Returns a value indicating whether events are registered for the control or any child controls.

(Herdado de Control)
IsLiteralContent()

Determina se o controle de servidor contém apenas o conteúdo literal.Determines if the server control holds only literal content.

(Herdado de Control)
LoadControlState(Object)

Restaura informações de estado de controle de uma solicitação de página anterior que foi salva pelo método SaveControlState().Restores control-state information from a previous page request that was saved by the SaveControlState() method.

(Herdado de Control)
LoadPostData(String, NameValueCollection)

Processa os dados postados para o controle ImageButton.Processes posted data for the ImageButton control.

LoadViewState(Object)

Restaura informações de estado de exibição de uma solicitação anterior que foi salva com o método SaveViewState().Restores view-state information from a previous request that was saved with the SaveViewState() method.

(Herdado de WebControl)
MapPathSecure(String)

Recupera o caminho físico para o qual um caminho virtual é mapeado, relativo ou virtual.Retrieves the physical path that a virtual path, either absolute or relative, maps to.

(Herdado de Control)
MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
MergeStyle(Style)

Copia os elementos não vazios do estilo especificado para o controle da Web, mas não substituirá os elementos de estilo existentes do controle.Copies any nonblank elements of the specified style to the Web control, but will not overwrite any existing style elements of the control. Esse método é usado principalmente por desenvolvedores de controle.This method is used primarily by control developers.

(Herdado de WebControl)
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.Determines whether the event for the server control is passed up the page's UI server control hierarchy.

(Herdado de Control)
OnClick(ImageClickEventArgs)

Gera o evento Click e permite manipular o evento Click diretamente.Raises the Click event and allows you to handle the Click event directly.

OnCommand(CommandEventArgs)

Gera o evento Command e permite manipular o evento Command diretamente.Raises the Command event and allows you to handle the Command event directly.

OnDataBinding(EventArgs)

Aciona o evento DataBinding.Raises the DataBinding event.

(Herdado de Control)
OnInit(EventArgs)

Aciona o evento Init.Raises the Init event.

(Herdado de Control)
OnLoad(EventArgs)

Aciona o evento Load.Raises the Load event.

(Herdado de Control)
OnPreRender(EventArgs)

Determina se a imagem foi clicada antes da renderização no cliente.Determines whether the image has been clicked prior to rendering on the client.

OnUnload(EventArgs)

Aciona o evento Unload.Raises the Unload event.

(Herdado de Control)
OpenFile(String)

Obtém um Stream usado para ler um arquivo.Gets a Stream used to read a file.

(Herdado de Control)
RaiseBubbleEvent(Object, EventArgs)

Atribui quaisquer fontes de evento e suas informações para o pai do controle.Assigns any sources of the event and its information to the control's parent.

(Herdado de Control)
RaisePostBackEvent(String)

Aciona eventos para o controle ImageButton quando ele executa um postback para o servidor.Raises events for the ImageButton control when it posts back to the server.

RaisePostDataChangedEvent()

Notifica o aplicativo ASP.NET de que o estado do controle ImageButton foi alterado.Notifies the ASP.NET application that the state of the ImageButton control has changed.

RemovedControl(Control)

Chamado após um controle filho ser removido da coleção Controls do objeto Control.Called after a child control is removed from the Controls collection of the Control object.

(Herdado de Control)
Render(HtmlTextWriter)

Renderiza o controle para o gravador de HTML especificado.Renders the control to the specified HTML writer.

(Herdado de WebControl)
RenderBeginTag(HtmlTextWriter)

Renderiza a marca de abertura HTML do controle para o gravador especificado.Renders the HTML opening tag of the control to the specified writer. Esse método é usado principalmente por desenvolvedores de controle.This method is used primarily by control developers.

(Herdado de WebControl)
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.Outputs the content of a server control's children to a provided HtmlTextWriter object, which writes the content to be rendered on the client.

(Herdado de Control)
RenderContents(HtmlTextWriter)

Renderiza o conteúdo de controle da imagem para o gravador especificado.Renders the image control contents to the specified writer.

(Herdado de Image)
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.Outputs server control content to a provided HtmlTextWriter object and stores tracing information about the control if tracing is enabled.

(Herdado de Control)
RenderControl(HtmlTextWriter, ControlAdapter)

Gera o conteúdo do controle de servidor a um objeto HtmlTextWriter fornecido usando um objeto ControlAdapter fornecido.Outputs server control content to a provided HtmlTextWriter object using a provided ControlAdapter object.

(Herdado de Control)
RenderEndTag(HtmlTextWriter)

Renderiza a marca de fechamento HTML do controle para o gravador especificado.Renders the HTML closing tag of the control into the specified writer. Esse método é usado principalmente por desenvolvedores de controle.This method is used primarily by control developers.

(Herdado de WebControl)
ResolveAdapter()

Obtém o adaptador de controle responsável por renderizar o controle especificado.Gets the control adapter responsible for rendering the specified control.

(Herdado de Control)
ResolveClientUrl(String)

Obtém uma URL que pode ser usada pelo navegador.Gets a URL that can be used by the browser.

(Herdado de Control)
ResolveUrl(String)

Converte uma URL em uma que possa ser usada no cliente solicitante.Converts a URL into one that is usable on the requesting client.

(Herdado de Control)
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.Saves any server control state changes that have occurred since the time the page was posted back to the server.

(Herdado de Control)
SaveViewState()

Salva qualquer estado que foi modificado depois que o método TrackViewState() foi invocado.Saves any state that was modified after the TrackViewState() method was invoked.

(Herdado de WebControl)
SetDesignModeState(IDictionary)

Define os dados de tempo de design para um controle.Sets design-time data for a control.

(Herdado de Control)
SetRenderMethodDelegate(RenderMethod)

Atribui um delegado do manipulador de eventos para renderizar o controle de servidor e seu conteúdo em seu controle pai.Assigns an event handler delegate to render the server control and its content into its parent control.

(Herdado de Control)
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.Sets trace data for design-time tracing of rendering data, using the trace data key and the trace data value.

(Herdado de Control)
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.Sets trace data for design-time tracing of rendering data, using the traced object, the trace data key, and the trace data value.

(Herdado de Control)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Herdado de Object)
TrackViewState()

Faz com que o controle acompanhe as alterações a seu estado de exibição para que eles possam ser armazenados na propriedade ViewState do objeto.Causes the control to track changes to its view state so they can be stored in the object's ViewState property.

(Herdado de WebControl)

Eventos

Click

Ocorre quando o ImageButton é clicado.Occurs when the ImageButton is clicked.

Command

Ocorre quando o ImageButton é clicado.Occurs when the ImageButton is clicked.

DataBinding

Ocorre quando o controle de servidor é associado a uma fonte de dados.Occurs when the server control binds to a data source.

(Herdado de Control)
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.Occurs when a server control is released from memory, which is the last stage of the server control lifecycle when an ASP.NET page is requested.

(Herdado de Control)
Init

Ocorre quando o controle de servidor é inicializado, que é a primeira etapa do ciclo de vida.Occurs when the server control is initialized, which is the first step in its lifecycle.

(Herdado de Control)
Load

Ocorre quando o controle de servidor é carregado no objeto Page.Occurs when the server control is loaded into the Page object.

(Herdado de Control)
PreRender

Ocorre depois que o objeto Control é carregado, mas antes da renderização.Occurs after the Control object is loaded but prior to rendering.

(Herdado de Control)
Unload

Ocorre quando o controle de servidor é descarregado da memória.Occurs when the server control is unloaded from memory.

(Herdado de Control)

Implantações explícitas de interface

IAttributeAccessor.GetAttribute(String)

Obtém um atributo do controle da Web com o nome especificado.Gets an attribute of the Web control with the specified name.

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

Define um atributo do controle da Web para o nome e o valor especificados.Sets an attribute of the Web control to the specified name and value.

(Herdado de WebControl)
IButtonControl.Click

Para obter uma descrição desse membro, consulte o evento Click.For a description of this member, see the Click event.

IButtonControl.Text

Para obter uma descrição desse membro, confira Text.For a description of this member, see Text.

IControlBuilderAccessor.ControlBuilder

Para obter uma descrição desse membro, confira ControlBuilder.For a description of this member, see ControlBuilder.

(Herdado de Control)
IControlDesignerAccessor.GetDesignModeState()

Para obter uma descrição desse membro, confira GetDesignModeState().For a description of this member, see GetDesignModeState().

(Herdado de Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Para obter uma descrição desse membro, confira SetDesignModeState(IDictionary).For a description of this member, see SetDesignModeState(IDictionary).

(Herdado de Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Para obter uma descrição desse membro, confira SetOwnerControl(Control).For a description of this member, see SetOwnerControl(Control).

(Herdado de Control)
IControlDesignerAccessor.UserData

Para obter uma descrição desse membro, confira UserData.For a description of this member, see UserData.

(Herdado de Control)
IDataBindingsAccessor.DataBindings

Para obter uma descrição desse membro, confira DataBindings.For a description of this member, see DataBindings.

(Herdado de Control)
IDataBindingsAccessor.HasDataBindings

Para obter uma descrição desse membro, confira HasDataBindings.For a description of this member, see HasDataBindings.

(Herdado de Control)
IExpressionsAccessor.Expressions

Para obter uma descrição desse membro, confira Expressions.For a description of this member, see Expressions.

(Herdado de Control)
IExpressionsAccessor.HasExpressions

Para obter uma descrição desse membro, confira HasExpressions.For a description of this member, see HasExpressions.

(Herdado de Control)
IParserAccessor.AddParsedSubObject(Object)

Para obter uma descrição desse membro, confira AddParsedSubObject(Object).For a description of this member, see AddParsedSubObject(Object).

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

Para obter uma descrição desse membro, confira LoadPostData(String, NameValueCollection).For a description of this member, see LoadPostData(String, NameValueCollection).

IPostBackDataHandler.RaisePostDataChangedEvent()

Para obter uma descrição desse membro, confira RaisePostDataChangedEvent().For a description of this member, see RaisePostDataChangedEvent().

IPostBackEventHandler.RaisePostBackEvent(String)

Para obter uma descrição desse membro, confira RaisePostBackEvent(String).For a description of this member, see RaisePostBackEvent(String).

Métodos de Extensão

FindDataSourceControl(Control)

Retorna a fonte de dados associada ao controle de dados do controle especificado.Returns the data source that is associated with the data control for the specified control.

FindFieldTemplate(Control, String)

Retorna o modelo do campo para a coluna especificada no contêiner de nomenclatura do controle especificado.Returns the field template for the specified column in the specified control's naming container.

FindMetaTable(Control)

Retorna o objeto metatable para o controle que contém dados.Returns the metatable object for the containing data control.

Aplica-se a

Confira também