LinkButton.CausesValidation-Eigenschaft
Ruft einen Wert ab, der angibt, ob beim Klicken auf das LinkButton-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 LinkButton
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 LinkButton-Steuerelement eine Validierung durchgeführt wird, andernfalls false. Der Standardwert ist true.
Hinweise
Standardmäßig wird beim Klicken auf ein LinkButton-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 LinkButton-Steuerelement geklickt wird. Wenn keine Validierung durchgeführt werden soll, muss die CausesValidation-Eigenschaft auf false festgelegt werden.
Diese Eigenschaft wird für eine Zurücksetzen- oder Entfernen-Schaltfläche im Allgemeinen auf false festgelegt, um die Validierung zu unterbinden, wenn auf die Schaltfläche geklickt wird.
Wenn der Wert der CausesValidation-Eigenschaft auf true festgelegt ist, können Sie außerdem mithilfe der ValidationGroup-Eigenschaft den Namen der Validierungsgruppe angeben, für die das LinkButton-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 die CausesValidation-Eigenschaft verwenden, damit keine Seitenvalidierung ausgeführt wird. Beachten Sie, wie mit der Validate-Methode jedes Validierungssteuerelement einzeln aktiviert wird.
<%@ 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, LinkButton)).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> 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>
<%@ Page Language="C#" AutoEventWireup="True" %>
<html>
<head>
<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 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>
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
LinkButton-Klasse
LinkButton-Member
System.Web.UI.WebControls-Namespace
Page.Validate
ValidationGroup