Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Ruft einen Wert ab, der angibt, ob beim Klicken auf das HtmlInputButton-Steuerelement eine Validierung durchgeführt wird, oder legt diesen fest.
Namespace: System.Web.UI.HtmlControls
Assembly: System.Web (in system.web.dll)
Syntax
'Declaration
Public Overridable Property CausesValidation As Boolean
'Usage
Dim instance As HtmlInputButton
Dim value As Boolean
value = instance.CausesValidation
instance.CausesValidation = value
public virtual bool CausesValidation { get; set; }
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 HtmlInputButton-Steuerelement eine Validierung durchgeführt wird, andernfalls false. Der Standardwert ist true.
Hinweise
Standardmäßig wird beim Klicken auf ein HtmlInputButton-Steuerelement eine Validierung durchgeführt. Die Seitenvalidierung bestimmt, 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 HtmlInputButton-Steuerelement geklickt wird. Wenn keine Validierung durchgeführt werden soll, muss die CausesValidation-Eigenschaft auf false festgelegt werden.
Diese Eigenschaft wird i. d. R. im Ereignishandler für das ServerClick-Ereignis verwendet, um das Ausführen der Seitenvalidierung zu verhindern, wenn auf eine Schaltfläche Abbrechen oder Zurücksetzen geklickt wird.
Beispiel
Im folgenden Codebeispiel wird veranschaulicht, wie Sie mit der CausesValidation-Eigenschaft verhindern, dass eine Seitenvalidierung ausgeführt wird. Beachten Sie, wie mit der Validate-Methode jedes Validierungssteuerelement einzeln aktiviert wird.
<%@ Page Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Sub SubmitButton_Click(ByVal sender As Object, ByVal e As EventArgs)
' Determine which button was clicked.
Select Case (CType(sender, HtmlInputButton)).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.InnerHtml = "You have chosen to run a query for the following city: " & _
CityTextBox.Value
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.InnerHtml = "You have chosen to run a query for the following state: " & _
StateTextBox.Value
End If
Case Else
' If the button clicked is not recognized, erase the message on the page.
Message.InnerHtml = ""
End Select
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>HtmlInputButton CausesValidation Example</title>
</head>
<body>
<form runat="server">
<h3> HtmlInputButton CausesValidation Example </h3>
<table border="1" cellpadding="10">
<tr>
<td>
<b>Enter city to query.</b> <br>
<input ID="CityTextBox"
Type="Text"
runat="server"/>
<asp:RequiredFieldValidator ID="CityReqValidator"
ControlToValidate="CityTextBox"
ErrorMessage="<br>Please enter a city."
Display="Dynamic"
EnableClientScript="False"
runat="server"/>
</td>
<td valign="bottom">
<input ID="CityQueryButton"
Type="Submit"
Value="Submit"
CausesValidation="False"
OnServerClick="SubmitButton_Click"
runat="server"/>
</td>
</tr>
<tr>
<td>
<b>Enter state to query.</b> <br>
<input ID="StateTextBox"
Type="Text"
runat="server"/>
<asp:RequiredFieldValidator ID="StateReqValidator"
ControlToValidate="StateTextBox"
ErrorMessage="<br>Please enter a state."
Display="Dynamic"
EnableClientScript="False"
runat="server"/>
</td>
<td valign="bottom">
<input ID="StateQueryButton"
Type="Submit"
Value="Submit"
CausesValidation="False"
OnServerClick="SubmitButton_Click"
runat="server"/>
</td>
</tr>
</table>
<br><br>
<span ID="Message"
runat="Server"/>
</form>
</body>
</html>
<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
void SubmitButton_Click(Object sender, EventArgs e)
{
// Determine which button was clicked.
switch (((HtmlInputButton)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.InnerHtml = "You have chosen to run a query for the following city: " +
CityTextBox.Value;
}
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.InnerHtml = "You have chosen to run a query for the following state: " +
StateTextBox.Value;
}
break;
default:
// If the button clicked is not recognized, erase the message on the page.
Message.InnerHtml = "";
break;
}
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
<title>HtmlInputButton CausesValidation Example</title>
</head>
<body>
<form runat="server">
<h3> HtmlInputButton CausesValidation Example </h3>
<table border="1" cellpadding="10">
<tr>
<td>
<b>Enter city to query.</b> <br>
<input ID="CityTextBox"
Type="Text"
runat="server"/>
<asp:RequiredFieldValidator ID="CityReqValidator"
ControlToValidate="CityTextBox"
ErrorMessage="<br>Please enter a city."
Display="Dynamic"
EnableClientScript="False"
runat="server"/>
</td>
<td valign="bottom">
<input ID="CityQueryButton"
Type="Submit"
Value="Submit"
CausesValidation="False"
OnServerClick="SubmitButton_Click"
runat="server"/>
</td>
</tr>
<tr>
<td>
<b>Enter state to query.</b> <br>
<input ID="StateTextBox"
Type="Text"
runat="server"/>
<asp:RequiredFieldValidator ID="StateReqValidator"
ControlToValidate="StateTextBox"
ErrorMessage="<br>Please enter a state."
Display="Dynamic"
EnableClientScript="False"
runat="server"/>
</td>
<td valign="bottom">
<input ID="StateQueryButton"
Type="Submit"
Value="Submit"
CausesValidation="False"
OnServerClick="SubmitButton_Click"
runat="server"/>
</td>
</tr>
</table>
<br><br>
<span 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
HtmlInputButton-Klasse
HtmlInputButton-Member
System.Web.UI.HtmlControls-Namespace
Page.Validate
ServerClick