HtmlInputButton.CausesValidation Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает значение, указывающее, выполняется ли проверка при щелчке HtmlInputButton элемента управления.
public:
property bool CausesValidation { bool get(); void set(bool value); };public:
virtual property bool CausesValidation { bool get(); void set(bool value); };public bool CausesValidation { get; set; }public virtual bool CausesValidation { get; set; }member this.CausesValidation : bool with get, setPublic Property CausesValidation As BooleanPublic Overridable Property CausesValidation As BooleanЗначение свойства
trueЗначение , falseесли проверка выполняется при HtmlInputButton щелчке элемента управления; в противном случае . Значение по умолчанию — true.
Примеры
В следующем примере кода показано, как использовать CausesValidation свойство для предотвращения возникновения проверки страниц. Обратите внимание, что Validate метод активирует каждый элемент управления проверки независимо.
<%@ 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 id="form1" 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="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 id="form1" 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>
Комментарии
По умолчанию проверка страниц выполняется при щелчке HtmlInputButton элемента управления. Проверка страницы определяет, передаются ли входные элементы управления, связанные с элементом управления проверки на странице, все правила проверки, указанные элементом управления проверки.
Можно указать или определить, выполняется ли проверка как на клиенте, так и на сервере при HtmlInputButton щелчке элемента управления с помощью CausesValidation свойства. Чтобы предотвратить выполнение проверки, задайте CausesValidation для свойства значение false.
Это свойство обычно используется в обработчике событий, ServerClick чтобы предотвратить проверку страницы при нажатии кнопки "Отмена" или "Сброс".
