ImageButton controle de servidor Web Declarative sintaxe
Permite lidar com cliques do usuário em uma imagem, que fornece funcionalidade semelhante a um MAP de imagem.
<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"
/>
Comentários
Use o ImageButton controle para exibir uma imagem que responde a cliques de mouse. Especifique a imagem a ser exibido no controle definindo a ImageUrl propriedade.
O Click e Command eventos são gerados quando o ImageButton controle é clicado.
Usando o OnClick manipulador de eventos, programaticamente, você pode determinar as coordenadas onde a imagem for clicada. Em seguida, você pode codificar uma resposta com base nos valores das coordenadas. Observação: a origem (0, 0) está localizado no canto superior esquerdo da imagem.
Você pode usar o OnCommand evento manipulador para tornar a ImageButton controle se comportam como um botão de comando. Um nome de comando pode ser associado com o controle usando o CommandName propriedade. Isso permite que vários ImageButton controles a serem colocados na mesma página da Web. O valor de CommandName propriedade, em seguida, pode ser identificada por meio de programação na OnCommand manipulador de eventos para determinar a ação apropriada para executar quando cada ImageButton controle é clicado. The CommandArgument propriedade também pode ser usada para passar informações adicionais sobre o comando, sistema autônomo especificar a ordem crescente.
.gif "Observação") Observação: |
|---|
Porque o <asp:ImageButton> elemento não tem conteúdo, você pode fechar a marca com /> em vez de usar uma marca de fechamento separada. |
Por padrão, validação de página é executada quando um ImageButton controle é clicado. Validação da página determina se os controles de entrada associados a um controle de validação na página passam as regras de validação especificadas pelo controle de validação. Se você tiver um ImageButton controle precisa desabilitar esse comportamento, sistema autônomo um reset botão, conjunto o CausesValidation propriedade para false.
Para obter informações detalhadas sobre o ImageButton Propriedades e eventos de controle de servidor de Web, consulte o ImageButton documentação da classe.
Exemplo
O exemplo a seguir demonstra como usar um ImageButton controle para exibir as coordenadas do ponteiro do mouse quando o ponteiro é clicado na imagem.
| Observação: |
|---|
Exemplo de código a seguir usa o modelo de arquivo único código e pode não funcionar corretamente se copiado diretamente em um arquivo code-behind. Este exemplo de código deve ser copiado em um arquivo de texto vazia que possui uma extensão.aspx. Para obter mais informações sobre o modelo de código de Web Forms, consulte Modelo de código de página Web do ASP.NET. |
<%@ 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>
<%@ 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="JScript" 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="JSCRIPT" runat="server">
function ImageButton_Click(sender : Object, e : ImageClickEventArgs) {
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>
Consulte também
Referência
Botão controle de servidor Web Declarative sintaxe