ImageButton.CausesValidation (Propiedad)
Ensamblado: System.Web (en system.web.dll)
/** @property */ public boolean get_CausesValidation () /** @property */ public void set_CausesValidation (boolean value)
public function get CausesValidation () : boolean public function set CausesValidation (value : boolean)
Valor de propiedad
Es true si se realiza la validación cuando se hace clic en el control ImageButton; en caso contrario, es false. El valor predeterminado es true.De manera predeterminada, la validación de la página se realiza al hacer clic en un control ImageButton. 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.
Se puede especificar o determinar si la validación se debe realizar tanto en el cliente como en el servidor al hacer clic en un control ImageButton mediante la propiedad CausesValidation. Para evitar que se realice la validación, establezca la propiedad CausesValidation en false.
Esta propiedad se establece normalmente en false para un botón de restablecimiento (Reset) o borrado (Clear) con el fin de evitar que se realice la validación al hacer clic en el botón.
Cuando el valor de la propiedad CausesValidation se establece en true, se puede utilizar también la propiedad ValidationGroup para especificar el nombre del grupo de validación para el que el control ImageButton ejecuta la validación.
Esta propiedad no se puede establecer por temas o temas de hoja de estilos. Para obtener más información, vea ThemeableAttribute y Información general sobre temas y máscaras de ASP.NET.
En el siguiente ejemplo se muestra cómo utilizar la propiedad CausesValidation para impedir que se produzca la validación de la página. Observe cómo el método Validate activa cada control de validación de forma independiente.
 Nota: |
|---|
| El ejemplo de código siguiente utiliza un modelo de código de un solo archivo y puede no funcionar correctamente si se copia directamente en un archivo con el código subyacente. Se debe copiar este ejemplo de código en un archivo de texto vacío con la extensión .aspx. Para obtener más información sobre el modelo de código de los formularios Web Forms, vea Modelo de código de las páginas Web ASP.NET. |
<%@ 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> ImageButton CausesValidation Example </title> <script runat="server"> void SubmitButton_Click(Object sender, ImageClickEventArgs e) { // Determine which button was clicked. switch(((ImageButton)sender).ID) { case "CityQueryButton": // Validate only the controls used for the city query. CityReqValidator.Validate(); // Take the appropriate action if the controls pass validation. if (CityReqValidator.IsValid) { Message.Text = "You have chosen to run a query for the following city: " + CityTextBox.Text; } break; case "StateQueryButton": // Validate only the controls used for the state query. StateReqValidator.Validate(); // Take the appropriate action if the controls pass validation. if (StateReqValidator.IsValid) { Message.Text = "You have chosen to run a query for the following state: " + StateTextBox.Text; } break; default: // If the button clicked isn't recognized, erase the message on the page. Message.Text = ""; break; } } </script> </head> <body> <form id="form1" runat="server"> <h3> ImageButton CausesValidation Example </h3> <table border="1" cellpadding="10"> <tr> <td> <b>Enter city to query.</b> <br /> <asp:TextBox ID="CityTextBox" runat="server"/> <asp:RequiredFieldValidator ID="CityReqValidator" ControlToValidate="CityTextBox" ErrorMessage="<br />Please enter a city." Display="Dynamic" EnableClientScript="False" runat="server"/> </td> <td valign="bottom"> <asp:ImageButton ID="CityQueryButton" ImageUrl="SubmitImage.jpg" CausesValidation="False" OnClick="SubmitButton_Click" runat="server"/> </td> </tr> <tr> <td> <b>Enter state to query.</b> <br /> <asp:TextBox ID="StateTextBox" runat="server"/> <asp:RequiredFieldValidator ID="StateReqValidator" ControlToValidate="StateTextBox" ErrorMessage="<br />Please enter a state." Display="Dynamic" EnableClientScript="False" runat="server"/> </td> <td valign="bottom"> <asp:ImageButton ID="StateQueryButton" ImageUrl="SubmitImage.jpg" CausesValidation="False" OnClick="SubmitButton_Click" runat="server"/> </td> </tr> </table> <br /><br /> <asp:Label ID="Message" runat="Server"/> </form> </body> </html>
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.