Exportar (0) Imprimir
Expandir todo

Button (Clase)

Actualización: noviembre 2007

Muestra un control de botón de comando en la página Web.

Espacio de nombres:  System.Web.UI.WebControls
Ensamblado:  System.Web (en System.Web.dll)

[AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level = AspNetHostingPermissionLevel.Minimal)]
public class Button : WebControl, IButtonControl, 
	IPostBackEventHandler
/** @attribute AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal) */
/** @attribute AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level = AspNetHostingPermissionLevel.Minimal) */
public class Button extends WebControl implements IButtonControl, 
	IPostBackEventHandler
public class Button extends WebControl implements IButtonControl, IPostBackEventHandler
<asp:Button />

Utilice el control Button para crear un botón de comando en la página Web. Se puede crear un botón Enviar o un botón Comando.

De manera predeterminada, un control Button es un botón Enviar. Un botón Enviar no tiene asociado un nombre de comando (especificado por la propiedad CommandName) y simplemente devuelve la página Web al servidor. 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 Enviar.

Un botón Comando puede tener asociado un nombre de comando, como Sort, mediante el establecimiento de la propiedad CommandName. Esto permite crear varios controles Button en una página Web y determinar mediante programación en qué control Button se hace clic. También se puede usar la propiedad CommandArgument con un botón de comando para facilitar información adicional sobre el comando que se va a ejecutar, como Ascending. Se puede proporcionar un controlador de eventos para el evento Command con el fin de controlar mediante programación las acciones realizadas cuando se hace clic en el botón Comando.

De manera predeterminada, se realiza la validación de la página cuando se hace clic en un control Button. 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.

TopicLocation
Tutorial: Crear elementos reutilizables con controles de usuario ASP.NETGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Crear y usar páginas principales ASP.NET en Visual Web DeveloperGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Agregar controles Button de servidor Web a una página de formularios Web Forms (Visual Studio)Generar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Crear un diseñador de controles básico para un control de servidor Web ASP.NETCrear controles ASP.NET
Cómo: Responder a los eventos de botón en elementos DataList, Repeater o GridViewGenerar aplicaciones Web ASP .NET
Cómo: Responder a los eventos de un control Button de servidor WebGenerar aplicaciones Web ASP .NET
Tutorial: Trabajar con estilos de las hojas de estilos en cascada en Visual Web DeveloperGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Validar los datos introducidos por el usuario en una página de formularios Web FormsGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Crear controladores de eventos en páginas Web ASP.NET (Visual Studio)Generar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Enlace de datos a un objeto comercial personalizadoGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Crear una página Web básica en Visual Web DeveloperGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Personalizar un sitio Web mediante temas en Visual StudioGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Conectar varios eventos con un único controlador de eventos en páginas Web ASP.NETGenerar aplicaciones Web ASP .NET
Cómo: Determinar qué control de servidor Web produce un eventoGenerar aplicaciones Web ASP .NET
Cómo: Establecer el foco en los controles de servidor Web ASP.NETGenerar aplicaciones Web ASP .NET
Cómo: Agregar controles PlaceHolder de servidor Web a una página de formularios Web FormsGenerar aplicaciones Web ASP .NET
Cómo: Responder a los eventos de un control Button de servidor Web en una secuencia de comandos del clienteGenerar aplicaciones Web ASP .NET
Cómo: Agregar controles Button de servidor Web a una página de formularios Web FormsGenerar aplicaciones Web ASP .NET
Cómo: Responder a eventos Button en controles enlazados a datosGenerar aplicaciones Web ASP .NET
Tutorial: Crear y usar páginas principales ASP.NET en Visual Web DeveloperGenerar aplicaciones con Visual Web Developer
Tutorial: Validar los datos introducidos por el usuario en una página de formularios Web FormsGenerar aplicaciones con Visual Web Developer
Cómo: Conectar varios eventos con un único controlador de eventos en páginas Web ASP.NETGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Determinar qué control de servidor Web produce un eventoGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Crear un diseñador de controles básico para un control de servidor WebGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Responder a los eventos de un control Button de servidor Web en una secuencia de comandos del clienteGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Crear elementos reutilizables con controles de usuario ASP.NETGenerar aplicaciones con Visual Web Developer
Cómo: Establecer el foco en los controles de servidor Web ASP.NETGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Crear controladores de eventos en páginas Web ASP.NET (Visual Studio)Generar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Enlace de datos a un objeto comercial personalizadoGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Crear una página Web básica en Visual Web DeveloperGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Agregar controles Button de servidor Web a una página de formularios Web Forms (Visual Studio)Generar aplicaciones Web ASP .NET en Visual Studio
Cómo: Responder a los eventos de un control Button de servidor WebGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Personalizar un sitio Web mediante temas en Visual StudioGenerar aplicaciones con Visual Web Developer
Cómo: Responder a eventos Button en controles enlazados a datosGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Responder a los eventos de botón en elementos DataList o RepeaterGenerar aplicaciones Web ASP .NET en Visual Studio

En el ejemplo de código siguiente se muestra cómo crear un control Button de envío que devuelve el contenido de la página Web al servidor.

<%@ 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>Button Example</title>
<script language="C#" runat="server">

      void SubmitBtn_Click(Object sender, EventArgs e) 
      {
         Message.Text="Hello World!!";
      }

   </script>
</head>
<body>
   <form id="form1" runat="server">

      <h3>Button Example</h3>

      Click on the submit button.<br /><br />

      <asp:Button id="Button1"
           Text="Submit"
           OnClick="SubmitBtn_Click" 
           runat="server"/>

      <br />

      <asp:label id="Message" runat="server"/>

   </form>
</body>
</html>


En el ejemplo de código siguiente se muestra cómo crear un control Button de comando que ordena una lista.

<%@ 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 runat="server">
    <title>Button CommandName Example</title>
<script runat="server">

      void CommandBtn_Click(Object sender, CommandEventArgs e) 
      {

         switch(e.CommandName)
         {

            case "Sort":

               // Call the method to sort the list.
               Sort_List((String)e.CommandArgument);
               break;

            case "Submit":

               // Display a message for the Submit button being clicked.
               Message.Text = "You clicked the Submit button";

               // Test whether the command argument is an empty string ("").
               if((String)e.CommandArgument == "")
               {
                  // End the message.
                  Message.Text += ".";
               }
               else
               {
                  // Display an error message for the command argument. 
                  Message.Text += ", however the command argument is not recogized.";
               }                
               break;

            default:

               // The command name is not recognized. Display an error message.
               Message.Text = "Command name not recogized.";
               break; 

         }

      }

      void Sort_List(string commandArgument)
      {

         switch(commandArgument)
         {

            case "Ascending":

               // Insert code to sort the list in ascending order here.
               Message.Text = "You clicked the Sort Ascending button.";
               break;

            case "Descending":

               // Insert code to sort the list in descending order here.
               Message.Text = "You clicked the Sort Descending button.";
               break;

            default:

               // The command argument is not recognized. Display an error message.
               Message.Text = "Command argument not recogized.";
               break;

         }

      }

   </script>

</head>

<body>

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

      <h3>Button CommandName Example</h3>

      Click on one of the command buttons.

      <br /><br />

      <asp:Button id="Button1"
           Text="Sort Ascending"
           CommandName="Sort"
           CommandArgument="Ascending"
           OnCommand="CommandBtn_Click" 
           runat="server"/>

      &nbsp;

      <asp:Button id="Button2"
           Text="Sort Descending"
           CommandName="Sort"
           CommandArgument="Descending"
           OnCommand="CommandBtn_Click" 
           runat="server"/>

      <br /><br />

      <asp:Button id="Button3"
           Text="Submit"
           CommandName="Submit"
           OnCommand="CommandBtn_Click" 
           runat="server"/>

      &nbsp;

      <asp:Button id="Button4"
           Text="Unknown Command Name"
           CommandName="UnknownName"
           CommandArgument="UnknownArgument"
           OnCommand="CommandBtn_Click" 
           runat="server"/>

      &nbsp;

      <asp:Button id="Button5"
           Text="Submit Unknown Command Argument"
           CommandName="Submit"
           CommandArgument="UnknownArgument"
           OnCommand="CommandBtn_Click" 
           runat="server"/>

      <br /><br />

      <asp:Label id="Message" runat="server"/>

   </form>

</body>
</html>



Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

.NET Framework

Compatible con: 3.5, 3.0, 2.0, 1.1, 1.0

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft