Button.CausesValidation-Eigenschaft
Ruft einen Wert ab, der angibt, ob beim Klicken auf das Button-Steuerelement eine Validierung durchgeführt wird, oder legt diesen fest.
Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)
Syntax
'Declaration
<ThemeableAttribute(False)> _
Public Overridable Property CausesValidation As Boolean
'Usage
Dim instance As Button
Dim value As Boolean
value = instance.CausesValidation
instance.CausesValidation = value
[ThemeableAttribute(false)]
public virtual bool CausesValidation { get; set; }
[ThemeableAttribute(false)]
public:
virtual property bool CausesValidation {
bool get ();
void set (bool value);
}
/** @property */
public boolean get_CausesValidation ()
/** @property */
public void set_CausesValidation (boolean value)
public function get CausesValidation () : boolean
public function set CausesValidation (value : boolean)
Eigenschaftenwert
true, wenn beim Klicken auf das Button-Steuerelement eine Validierung durchgeführt wird, andernfalls false. Der Standardwert ist true.
Hinweise
Standardmäßig wird beim Klicken auf ein Button-Steuerelement eine Seitenvalidierung durchgeführt. Die Seitenvalidierung ermittelt, ob die einem Validierungssteuerelement auf der Seite zugeordneten Eingabesteuerelemente allen Validierungsregeln entsprechen, die durch das Validierungssteuerelement festgelegt sind.
Sie können mithilfe der CausesValidation-Eigenschaft angeben oder ermitteln, ob die Validierung sowohl auf dem Client als auch auf dem Server durchgeführt wird, wenn auf ein Button-Steuerelement geklickt wird. Wenn keine Validierung durchgeführt werden soll, muss die CausesValidation-Eigenschaft auf false festgelegt werden.
Diese Eigenschaft wird für eine Schaltfläche Reset oder Clear i. Allg. auf false festgelegt, um die Validierung zu unterbinden, wenn auf die Schaltfläche geklickt wird.
Wenn der Wert der CausesValidation-Eigenschaft auf true gesetzt ist, können Sie außerdem mithilfe der ValidationGroup-Eigenschaft den Namen der Validierungsgruppe angeben, für die das Button-Steuerelement eine Validierung auslöst.
Diese Eigenschaft kann nicht durch Designs oder Stylesheetdesigns festgelegt werden. Weitere Informationen finden Sie unter ThemeableAttribute und Übersicht über ASP.NET-Designs und ASP.NET-Skins.
Beispiel
Das folgende Beispiel veranschaulicht, wie Sie mithilfe der CausesValidation-Eigenschaft verhindern können, dass die Seitenvalidierung durchgeführt wird. Beachten Sie, dass die Validate-Methode jedes Validierungssteuerelement einzeln aktiviert.
<%@ Page Language="VB" AutoEventWireup="True" %>
<html>
<head>
<script runat="server">
Sub SubmitButton_Click(sender As Object, e As EventArgs)
' Determine which button was clicked.
Select Case (CType(sender, Button)).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 Then
Message.Text = "You have chosen to run a query for the following city: " & _
CityTextBox.Text
End If
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 Then
Message.Text = "You have chosen to run a query for the following state: " & _
StateTextBox.Text
End If
Case Else
' If the button clicked isn't recognized, erase the message on the page.
Message.Text = ""
End Select
End Sub
</script>
</head>
<body>
<form runat="server">
<h3> Button 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:Button 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:Button 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>
<%@ Page Language="C#" AutoEventWireup="True" %>
<html>
<head>
<script runat="server">
void SubmitButton_Click(Object sender, EventArgs e)
{
// Determine which button was clicked.
switch(((Button)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 runat="server">
<h3> Button 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:Button 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:Button 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>
Plattformen
Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
Siehe auch
Referenz
Button-Klasse
Button-Member
System.Web.UI.WebControls-Namespace
Page.Validate
ValidationGroup