BaseValidator.IsValid Tulajdonság
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
Lekéri vagy beállít egy értéket, amely jelzi, hogy a társított beviteli vezérlő megfelel-e az ellenőrzésnek.
public:
property bool IsValid { bool get(); void set(bool value); };
[System.ComponentModel.Browsable(false)]
public bool IsValid { get; set; }
[System.ComponentModel.Browsable(false)]
[System.Web.UI.Themeable(false)]
public bool IsValid { get; set; }
[<System.ComponentModel.Browsable(false)>]
member this.IsValid : bool with get, set
[<System.ComponentModel.Browsable(false)>]
[<System.Web.UI.Themeable(false)>]
member this.IsValid : bool with get, set
Public Property IsValid As Boolean
Tulajdonság értéke
trueha a kapcsolódó beviteli vezérlő megfelel az ellenőrzésnek; egyéb esetben. false Az alapértelmezett érték a true.
Megvalósítás
- Attribútumok
Példák
Az alábbi példakód bemutatja, hogyan használható a tulajdonság annak IsValid meghatározására, hogy a társított beviteli vezérlő megfelel-e az ellenőrzésnek.
Important
Ebben a példában egy szövegdoboz található, amely elfogadja a felhasználói bemenetet, ami potenciális biztonsági fenyegetés. Alapértelmezés szerint ASP.NET weblapok ellenőrzik, hogy a felhasználói bevitel nem tartalmaz-e szkript- vagy HTML-elemeket. További információ: Szkript kihasználása – áttekintés.
<%@ 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 Button_Click(Object sender, EventArgs e)
{
if (NumberCompareValidator.IsValid && TextBoxRequiredValidator.IsValid)
{
MessageLabel.Text = "Page submitted successfully.";
}
else
{
MessageLabel.Text = "There is an error on the page.";
}
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>Validator Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>Validator Example</h3>
Enter a number from 1 to 10.
<asp:textbox id="NumberTextBox"
runat="server"/>
<asp:rangevalidator id="NumberCompareValidator"
controltovalidate="NumberTextBox"
enableclientscript="False"
type="Integer"
display="Dynamic"
errormessage="Please enter a value from 1 to 10."
maximumvalue="10"
minimumvalue="1"
text="*"
runat="server"/>
<asp:requiredfieldvalidator id="TextBoxRequiredValidator"
controltovalidate="NumberTextBox"
enableclientscript="False"
display="Dynamic"
errormessage="Please enter a value."
text="*"
runat="server"/>
<br /><br />
<asp:button id="SubmitButton"
text="Submit"
onclick="Button_Click"
runat="server"/>
<br /><br />
<asp:label id="MessageLabel"
runat="server"/>
<br /><br />
<asp:validationsummary
id="ErrorSummary"
runat="server"/>
</form>
</body>
</html>
<%@ Page Language="VB" AutoEventWireup="False" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Sub Button_Click(ByVal sender As Object, ByVal e As EventArgs) Handles SubmitButton.Click
If NumberCompareValidator.IsValid And TextBoxRequiredValidator.IsValid Then
MessageLabel.Text = "Page submitted successfully."
Else
MessageLabel.Text = "There is an error on the page."
End If
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>Validator Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>Validator Example</h3>
Enter a number from 1 to 10.
<asp:textbox id="NumberTextBox"
runat="server"/>
<asp:rangevalidator id="NumberCompareValidator"
controltovalidate="NumberTextBox"
enableclientscript="False"
type="Integer"
display="Dynamic"
errormessage="Please enter a value from 1 to 10."
maximumvalue="10"
minimumvalue="1"
text="*"
runat="server"/>
<asp:requiredfieldvalidator id="TextBoxRequiredValidator"
controltovalidate="NumberTextBox"
enableclientscript="False"
display="Dynamic"
errormessage="Please enter a value."
text="*"
runat="server"/>
<br /><br />
<asp:button id="SubmitButton"
text="Submit"
runat="server"/>
<br /><br />
<asp:label id="MessageLabel"
runat="server"/>
<br /><br />
<asp:validationsummary
id="ErrorSummary"
runat="server"/>
</form>
</body>
</html>
Megjegyzések
IsValid A tulajdonság használatával állapítsa meg, hogy a társított beviteli vezérlő megfelel-e az ellenőrzésnek.
Figyelmeztetés
Mivel ennek a tulajdonságnak az alapértelmezett értéke, truea tulajdonság akkor jelenik meg true , ha az ellenőrzés végrehajtása előtt lekérdezi ezt a tulajdonságot. Ez például akkor fordulhat elő, ha ezt a Control.Load tulajdonságot oldal esetén próbálja meg használni.
A IsValid tulajdonság kiértékelése csak a Validate metódus meghívásakor történik. A lapon található egyes érvényesítési vezérlők metódusát egyenként hívhatja Validate meg, vagy egyszerre is meghívhatja őket a Page.Validate metódus használatával. A metódus meghívására szolgáló tulajdonsággal CausesValidation rendelkező gombvezérlők is meghívják a metódusttrue.Page.Validate
Note
Az ellenőrzés után manuálisan is módosíthatja a tulajdonság értékét. Ez lehetővé teszi, hogy szükség esetén felülbírálja az érvényesítési eredményt.
A Page.IsValid lap tulajdonsága csak akkor van beállítva true , ha a IsValid lapon található egyes érvényesítési vezérlők tulajdonsága is be van állítva true.
Ez a tulajdonság nem állítható be témák vagy stíluslaptémák szerint. További információ: ThemeableAttribute és ASP.NET Témák és bőrök.