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 HtmlInputImage-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 HtmlInputImage
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 HtmlInputImage-Steuerelement eine Validierung durchgeführt wird, andernfalls false. Der Standardwert ist true.
Hinweise
In der Standardeinstellung wird beim Klicken auf ein HtmlInputImage-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 HtmlInputImage-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" AutoEventWireup="True" %>
<script runat="server">
Sub SubmitButton_Click(ByVal sender As Object, ByVal e As ImageClickEventArgs)
' Determine which button was clicked.
Select Case (CType(sender, HtmlInputImage)).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 isn not recognized, erase the message on the page.
Message.InnerHtml = ""
End Select
End Sub
</script>
<html>
<head>
</head>
<body>
<form runat="server">
<h3> HtmlInputImage 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"
Alt="City Submit button"
Type="Image"
Src="SubmitImage.jpg"
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"
Alt="State Submit button"
Type="Image"
Src="SubmitImage.jpg"
CausesValidation="False"
OnServerClick="SubmitButton_Click"
runat="server"/>
</td>
</tr>
</table>
<br><br>
<span ID="Message"
runat="Server"/>
</form>
</body>
</html>
<%@ Page Language="C#" AutoEventWireup="True" %>
<script runat="server">
void SubmitButton_Click(Object sender, ImageClickEventArgs e)
{
// Determine which button was clicked.
switch (((HtmlInputImage)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>
<head>
</head>
<body>
<form runat="server">
<h3> HtmlInputImage 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"
Alt="City Submit button"
Type="Image"
Src="image.jpg"
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"
Alt="State Submit button"
Type="Image"
Src="image.jpg"
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
HtmlInputImage-Klasse
HtmlInputImage-Member
System.Web.UI.HtmlControls-Namespace
Page.Validate
ValidationGroup