LinkButton.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 la validación se realiza al hacer clic en el control LinkButton; en caso contrario, es false. El valor predeterminado es true.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.
Se puede especificar o determinar si la validación debe realizarse tanto en el cliente como en el servidor cuando se hace clic en un control LinkButton 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 LinkButton 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: de seguridad |
|---|
| Este ejemplo tiene un cuadro de texto que acepta datos del usuario, lo que puede suponer una amenaza para la seguridad. De forma predeterminada, las páginas Web ASP.NET validan que los datos proporcionados por el usuario no incluyen elementos HTML ni de secuencia de comandos. Para obtener más información, vea Información general sobre los ataques mediante secuencias de comandos. |
<%@ 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> LinkButton CausesValidation Example </title> <script runat="server"> void SubmitButton_Click(Object sender, EventArgs e) { // Determine which button was clicked. switch(((LinkButton)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> LinkButton 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:LinkButton ID="CityQueryButton" Text="Submit" 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:LinkButton ID="StateQueryButton" Text="Submit" 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.