Sintaxis declarativa del control de servidor Web LinkButton
Actualización: noviembre 2007
Crea un botón de hipervínculo en una página de formularios Web Forms.
<asp:LinkButton
AccessKey="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"
Enabled="True|False"
EnableTheming="True|False"
EnableViewState="True|False"
Font-Bold="True|False"
Font-Italic="True|False"
Font-Names="string"
Font-Overline="True|False"
Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
Large|X-Large|XX-Large"
Font-Strikeout="True|False"
Font-Underline="True|False"
ForeColor="color name|#dddddd"
Height="size"
ID="string"
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"
Text="string"
ToolTip="string"
ValidationGroup="string"
Visible="True|False"
Width="size"
/>
Comentarios
Utilice el control LinkButton para crear un botón de hipervínculo en una página de formularios Web Forms. Especifique el texto que se va a mostrar en el control LinkButton estableciendo el valor de la propiedad Text o colocando el texto entre las etiquetas de apertura y de cierre del control LinkButton. Se puede crear un botón de envío o un botón de comando.
Nota
El control LinkButton tiene la misma apariencia que un control HyperLink, pero tiene la misma funcionalidad que un control Button. Utilice el control HyperLink si desea establecer un vínculo a otra página Web cuando se hace clic en el control.
Un botón submit no tiene nombre de comando asociado y simplemente devuelve la página Web al servidor. De manera predeterminada, un control LinkButton es un botón submit. Se puede proporcionar un controlador de eventos para el evento Click con el fin de controlar mediante programación las acciones que se llevan a cabo cuando se hace clic en el botón submit.
Al establecer el valor de la propiedad CommandName, se puede asociar un nombre de comando al botón de comando, como Sort. Esto permite crear varios controles LinkButton en una página Web y determinar mediante programación en qué control LinkButton se hace clic. Asimismo, se puede usar la propiedad CommandArgument con un botón de comando para proporcionar información adicional sobre el comando que se va a llevar a cabo, como por ejemplo Ascending. Se puede proporcionar un controlador de eventos para el evento Command con el fin de controlar mediante programación las acciones que se llevan a cabo cuando se hace clic en el botón de comando.
Nota
El control LinkButton representa JavaScript en el explorador del cliente. El explorador del cliente debe tener habilitado JavaScript para que este control funcione correctamente. Para obtener más información sobre las secuencias de comandos en el cliente, vea Script de cliente en páginas web ASP.NET. De manera predeterminada, la página se valida cuando se hace clic en un control LinkButton. La validación de la página determina si los controles de entrada asociados a un control de validación en la página cumplen las reglas de validación especificadas por el control de validación. Si hay un control LinkButton que tiene que deshabilitar este comportamiento, como un botón reset, establezca el valor de la propiedad CausesValidation en false.
.gif "Nota de precaución") Precaución: |
|---|
El texto no tiene código HTML antes de mostrarse en el control LinkButton. Esto permite incrustar una secuencia de comandos en las etiquetas HTML del texto. Si los valores del control provienen de la entrada del usuario, asegúrese de validar los valores para ayudar a evitar puntos vulnerables en la seguridad. |
Los botones Command (como los controles LinkButton) se utilizan con frecuencia en los controles con plantilla para comunicar una acción al control primario. Por ejemplo, la selección que se realiza en una lista DataList o el cambio de modo en una vista FormView.
Para obtener más detalles sobre las propiedades y los eventos del control de servidor Web LinkButton, consulte la documentación relativa a la clase LinkButton.
Ejemplo
En el siguiente ejemplo se muestra cómo usar un control LinkButton para mostrar un mensaje cuando se hace clic en el control.
<%@ 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>LinkButton Example</title>
<script language="VB" runat="server">
Sub LinkButton_Click(sender As Object, e As EventArgs)
Label1.Text = "You clicked the link button"
End Sub
</script>
</head>
<body>
<form id="form1" runat="server">
<h3>LinkButton Example</h3>
<asp:LinkButton id="LinkButton1"
Text="Click Me"
Font-Names="Verdana"
Font-Size="14pt"
OnClick="LinkButton_Click"
runat="server"/>
<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>LinkButton Example</title>
<script language="C#" runat="server">
void LinkButton_Click(Object sender, EventArgs e)
{
Label1.Text="You clicked the link button";
}
</script>
</head>
<body>
<form id="form1" runat="server">
<h3>LinkButton Example</h3>
<asp:LinkButton id="LinkButton1"
Text="Click Me"
Font-Names="Verdana"
Font-Size="14pt"
OnClick="LinkButton_Click"
runat="server"/>
<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>LinkButton Example</title>
<script language="JSCRIPT" runat="server">
function LinkButton_Click(sender : Object, e : EventArgs){
Label1.Text = "You clicked the link button"
}
</script>
</head>
<body>
<form id="form1" runat="server">
<h3>LinkButton Example</h3>
<asp:LinkButton id="LinkButton1"
Text="Click Me"
Font-Names="Verdana"
Font-Size="14pt"
OnClick="LinkButton_Click"
runat="server"/>
<br />
<asp:Label id="Label1" runat="server" />
</form>
</body>
</html>