BaseValidator.EnableClientScript Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die clientseitige Überprüfung aktiviert ist.
public:
property bool EnableClientScript { bool get(); void set(bool value); };public bool EnableClientScript { get; set; }[System.Web.UI.Themeable(false)]
public bool EnableClientScript { get; set; }member this.EnableClientScript : bool with get, set[<System.Web.UI.Themeable(false)>]
member this.EnableClientScript : bool with get, setPublic Property EnableClientScript As BooleanEigenschaftswert
truewenn die clientseitige Überprüfung aktiviert ist; andernfalls . false Der Standardwert ist true.
- Attribute
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie die Eigenschaft zum Deaktivieren der EnableClientScript clientseitigen Überprüfung verwendet wird, sodass die Zufallszahlen auf dem Server generiert werden können.
Von Bedeutung
In diesem Beispiel handelt es sich um ein Textfeld, das Benutzereingaben akzeptiert, bei denen es sich um eine potenzielle Sicherheitsrisiken handelt. Standardmäßig überprüfen ASP.NET Webseiten, dass die Benutzereingabe keine Skript- oder HTML-Elemente enthält. Weitere Informationen finden Sie unter Script Exploits Overview.
<%@ 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 (Page.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 Page.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>
Hinweise
Verwenden Sie die EnableClientScript Eigenschaft, um anzugeben, ob die clientseitige Überprüfung aktiviert ist.
Überprüfungssteuerelemente führen immer eine Überprüfung auf dem Server durch. Sie verfügen auch über eine vollständige clientseitige Implementierung, mit der DHTML-unterstützte Browser (z. B. Microsoft Internet Explorer 4.0 und höher) eine Überprüfung auf dem Client durchführen können. Die clientseitige Überprüfung verbessert den Überprüfungsprozess, indem die Benutzereingabe überprüft wird, bevor sie an den Server gesendet wird. Auf diese Weise können Fehler auf dem Client erkannt werden, bevor das Formular übermittelt wird, wodurch der Roundtrip von Informationen vermieden wird, die für die serverseitige Überprüfung erforderlich sind.
Standardmäßig ist dieser Wert auf true", der die clientseitige Überprüfung ermöglicht, wenn der Browser ihn unterstützt. Sie können die clientseitige Überprüfung auf Steuerelementbasis deaktivieren. Dies ist nützlich, wenn beim dynamischen Aktualisieren auf dem Client Probleme mit dem Layout der Seite auftreten, oder wenn Sie vor der Überprüfung einen Servercode ausführen möchten.
Diese Eigenschaft kann nicht durch Designs oder Stylesheetdesigns festgelegt werden. Weitere Informationen finden Sie unter ThemeableAttribute und ASP.NET Designs und Skins.
