LinkButton (Clase)
Ensamblado: System.Web (en system.web.dll)
Utilice el control LinkButton para crear un botón de tipo hipervínculo en la página Web. El control LinkButton tiene la misma apariencia que un control HyperLink, pero tiene la misma funcionalidad que un control Button. Si desea establecer un vínculo a otra página Web al hacer clic en el control, utilice el control HyperLink.
 Nota: |
|---|
| El control LinkButton representa el código JavaScript en el explorador cliente. El explorador cliente debe tener JavaScript habilitado para que este control funcione correctamente. Para obtener más información sobre secuencias de comandos de cliente, vea Secuencias de comandos del cliente en páginas Web ASP.NET. |
Se puede crear un botón de envío (Submit) o un botón de comando (Command). Un botón de envío no tiene asociado un nombre de comando. El botón simplemente devuelve la página Web al servidor. De manera predeterminada, un control LinkButton es un botón de envío. Se puede proporcionar un controlador de eventos para el evento Click con el fin de controlar mediante programación las acciones realizadas cuando se hace clic en el botón de envío. Por otra parte, un botón de comando tiene asociado un nombre de comando al botón, como, por ejemplo, Sort. Establezca la propiedad CommandName para especificar el nombre de comando. Esto permite crear varios controles LinkButton en una página Web y determinar mediante programación en qué control LinkButton se hace clic. También se puede utilizar la propiedad CommandArgument con un botón de comando para facilitar información adicional sobre el comando que se va a ejecutar, como, por ejemplo, especificar el orden ascendente. Se puede proporcionar asimismo un controlador de eventos para el evento Command con el fin de controlar mediante programación la acción realizada cuando se hace clic en el botón de comando.
| Precaución: |
|---|
| Este control se puede utilizar para mostrar los datos proporcionados por el usuario, que pueden incluir secuencias de comandos de cliente malintencionadas. Compruebe que cualquier información que se envíe desde un cliente no contiene secuencias de comandos ejecutables, instrucciones SQL o cualquier otro código antes de mostrarla en la aplicación. ASP .NET proporciona una función de validación de las solicitudes de entrada de datos para bloquear secuencias de comandos y código HTML en los datos proporcionados por el usuario. También se proporcionan controles de servidor de validación para evaluar los datos especificados por el usuario. Para obtener más información, vea Sintaxis de los controles de servidor Validation. |
De manera predeterminada, la validación de la página se realiza cuando se hace clic en un control LinkButton. La validación de la página determina si todos 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. Para evitar que se realice la validación de la página, establezca la propiedad CausesValidation en false.
Accesibilidad
Es posible que el marcado que se representa de manera predeterminada para este control no respete los estándares de accesibilidad enunciados en las directrices prioritarias de WCAG (Instrucciones de accesibilidad a contenido Web 1.0). Para obtener detalles sobre accesibilidad compatible con este control, vea Controles y accesibilidad en ASP.NET.
En el siguiente ejemplo se muestra cómo crear un control LinkButton que muestra texto en un control Label cuando se hace clic en el vínculo.
<%@ 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>
- AspNetHostingPermission Para trabajar en un entorno alojado en host. Valor de la petición: LinkDemand; valor del permiso: Minimal.
- AspNetHostingPermission Para trabajar en un entorno alojado en host. Valor de la petición: InheritanceDemand; valor del permiso: Minimal.
System.Web.UI.Control
System.Web.UI.WebControls.WebControl
System.Web.UI.WebControls.LinkButton
Windows 98, Windows 2000 Service Pack 4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter
Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.