PostBackOptions.PerformValidation Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Получает и задает значение, указывающее, требуется ли проверка на стороне клиента перед обратной передачей.
public:
property bool PerformValidation { bool get(); void set(bool value); };
public bool PerformValidation { get; set; }
member this.PerformValidation : bool with get, set
Public Property PerformValidation As Boolean
Значение свойства
Значение true
, если перед обратной передачей требуется проверка на стороне клиента, в противном случае значение — false
. Значение по умолчанию — false
.
Примеры
В следующем примере кода показано использование ValidationGroup свойств и PerformValidation для обеспечения того, чтобы в двух TextBox элементах управления были введены сведения до создания события обратной передачи. Элементы NameTextBox
управления и AgeTextBox
являются частью PersonalInfoGroup
группы проверки, но StateTextBox
это не так. Поэтому пользователю не нужно вводить какие-либо данные в StateTextBox
элементе управления перед созданием события обратной передачи.
Важно!
В этом примере имеется текстовое поле, принимающее вводимые пользователем данные, что является потенциальной угрозой безопасности. По умолчанию данные, вводимые пользователем на веб-страницах ASP.NET, проверяются на наличие скриптов и 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 Page_Init(object sender, EventArgs e)
{
PostBackOptions myPostBackOptions = new PostBackOptions(FruitRadioButtonList);
myPostBackOptions.RequiresJavaScriptProtocol = true;
myPostBackOptions.PerformValidation = true;
myPostBackOptions.ValidationGroup = "PersonalInfoGroup";
string reference = Page.ClientScript.GetPostBackEventReference(myPostBackOptions);
FruitRadioButtonList.Attributes.Add("onclick", reference);
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
<title>PerformValidation and ValidationGroup Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>PostBackOptions PerformValidation and ValidationGroup Example</h3>
<asp:label id="NameLabel"
text="Enter your name:"
runat="server"
AssociatedControlID="NameTextBox">
</asp:label>
 
<asp:textbox id="NameTextBox"
runat="server">
</asp:textbox>
 
<asp:requiredfieldvalidator id="RequiredFieldValidator1"
controltovalidate="NameTextBox"
validationgroup="PersonalInfoGroup"
errormessage="Enter your name."
runat="server">
</asp:requiredfieldvalidator>
<br /><br />
<asp:label id="AgeLabel"
text="Enter your age:"
runat="server"
AssociatedControlID="AgeTextBox">
</asp:label>
 
<asp:textbox id="AgeTextBox"
runat="server">
</asp:textbox>
 
<asp:requiredfieldvalidator id="RequiredFieldValidator2"
controltovalidate="AgeTextBox"
validationgroup="PersonalInfoGroup"
errormessage="Enter your age."
runat="server">
</asp:requiredfieldvalidator>
<br /><br />
<asp:label id="State"
text="Enter the state where you live:"
runat="server"
AssociatedControlID="StateTextBox">
</asp:label>
 
<asp:textbox id="StateTextBox"
runat="server">
</asp:textbox>
 
<br /><br />
<asp:Label id="FruitLabel"
text="Please select your preferred fruit:"
runat="server"
AssociatedControlID="FruitRadioButtonList">
</asp:Label>
<asp:RadioButtonList ID="FruitRadioButtonList" runat="server" >
<asp:ListItem>Apples</asp:ListItem>
<asp:ListItem>Oranges</asp:ListItem>
<asp:ListItem>Pears</asp:ListItem>
<asp:ListItem>Peaches</asp:ListItem>
<asp:ListItem>Grapes</asp:ListItem>
<asp:ListItem>Lemons</asp:ListItem>
<asp:ListItem>Limes</asp:ListItem>
<asp:ListItem>Plums</asp:ListItem>
</asp:RadioButtonList>
</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 Page_Init(ByVal sender As Object, ByVal e As EventArgs)
Dim myPostBackOptions As PostBackOptions = New PostBackOptions(FruitRadioButtonList)
myPostBackOptions.RequiresJavaScriptProtocol = True
myPostBackOptions.PerformValidation = True
myPostBackOptions.ValidationGroup = "PersonalInfoGroup"
Dim reference As String = Page.ClientScript.GetPostBackEventReference(myPostBackOptions)
FruitRadioButtonList.Attributes.Add("onclick", reference)
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
<title>PerformValidation and ValidationGroup Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>PostBackOptions PerformValidation and ValidationGroup Example</h3>
<asp:label id="NameLabel"
text="Enter your name:"
runat="server"
AssociatedControlID="NameTextBox">
</asp:label>
 
<asp:textbox id="NameTextBox"
runat="server">
</asp:textbox>
 
<asp:requiredfieldvalidator id="RequiredFieldValidator1"
controltovalidate="NameTextBox"
validationgroup="PersonalInfoGroup"
errormessage="Enter your name."
runat="server">
</asp:requiredfieldvalidator>
<br /><br />
<asp:label id="AgeLabel"
text="Enter your age:"
runat="server"
AssociatedControlID="AgeTextBox">
</asp:label>
 
<asp:textbox id="AgeTextBox"
runat="server">
</asp:textbox>
 
<asp:requiredfieldvalidator id="RequiredFieldValidator2"
controltovalidate="AgeTextBox"
validationgroup="PersonalInfoGroup"
errormessage="Enter your age."
runat="server">
</asp:requiredfieldvalidator>
<br /><br />
<asp:label id="State"
text="Enter the state where you live:"
runat="server"
AssociatedControlID="State">
</asp:label>
 
<asp:textbox id="StateTextBox"
runat="server">
</asp:textbox>
 
<br /><br />
<asp:Label id="FruitLabel"
text="Please select your preferred fruit:"
runat="server"
AssociatedControlID="FruitRadioButtonList">
</asp:Label>
<asp:RadioButtonList ID="FruitRadioButtonList" runat="server" >
<asp:ListItem>Apples</asp:ListItem>
<asp:ListItem>Oranges</asp:ListItem>
<asp:ListItem>Pears</asp:ListItem>
<asp:ListItem>Peaches</asp:ListItem>
<asp:ListItem>Grapes</asp:ListItem>
<asp:ListItem>Lemons</asp:ListItem>
<asp:ListItem>Limes</asp:ListItem>
<asp:ListItem>Plums</asp:ListItem>
</asp:RadioButtonList>
</form>
</body>
</html>
Комментарии
Свойство PerformValidation используется, чтобы указать, требуется ли проверка на стороне клиента перед событием обратной передачи. Если для свойства задано значение PerformValidationtrue
, можно также использовать ValidationGroup свойство , чтобы указать имя группы проверки, для которой требуется проверка перед событием обратной передачи.