BaseValidator.EnableClientScript Eigenschaft

Definition

Ruft einen Wert ab, der angibt, ob die Validierung auf dem Client aktiviert ist, oder legt diesen fest.Gets or sets a value indicating whether client-side validation is enabled.

public:
 property bool EnableClientScript { bool get(); void set(bool value); };
[System.Web.UI.Themeable(false)]
public bool EnableClientScript { get; set; }
member this.EnableClientScript : bool with get, set
Public Property EnableClientScript As Boolean

Eigenschaftswert

true, wenn die Validierung auf dem Client aktiviert ist, andernfalls false.true if client-side validation is enabled; otherwise, false. Der Standardwert ist truesein.The default value is true.

Attribute

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die EnableClientScript -Eigenschaft verwendet wird, um die Client seitige Validierung zu deaktivieren, sodass die Zufallszahlen auf dem Server generiert werden können.The following code example demonstrates how to use the EnableClientScript property to disable client-side validation so that the random numbers can be generated on the server.

Wichtig

Dieses Beispiel umfasst ein Textfeld, das Benutzereingaben akzeptiert, die ein potenzielles Sicherheitsrisiko darstellen.This example has a text box that accepts user input, which is a potential security threat. Standardmäßig stellen ASP.NET-Webseiten sicher, dass Benutzereingaben keine Skript- oder HTML-Elemente enthalten.By default, ASP.NET Web pages validate that user input does not include script or HTML elements. Weitere Informationen finden Sie unter Übersicht über Skriptangriffe.For more information, see 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 EnableClientScript die-Eigenschaft, um anzugeben, ob die Client seitige Validierung aktiviert ist.Use the EnableClientScript property to specify whether client-side validation is enabled.

Validierungs Steuerelemente führen immer eine Überprüfung auf dem Server durch.Validation controls always perform validation on the server. Außerdem verfügen Sie über eine vollständige Client seitige Implementierung, mit der von DHTML unterstützte Browser (z. b. Microsoft Internet Explorer 4,0 und höher) eine Validierung auf dem Client durchführen können.They also have complete client-side implementation that allows DHTML-supported browsers (such as Microsoft Internet Explorer 4.0 and later) to perform validation on the client. Die Client seitige Validierung verbessert den Validierungsprozess, indem die Benutzereingaben überprüft werden, bevor Sie an den Server gesendet werden.Client-side validation enhances the validation process by checking user input before it is sent to the server. Dies ermöglicht das Erkennen von Fehlern auf dem Client, bevor das Formular gesendet wird. Dadurch wird der Roundtrip von Informationen vermieden, die für die serverseitige Validierung erforderlich sind.This allows errors to be detected on the client before the form is submitted, avoiding the round trip of information necessary for server-side validation.

Standardmäßig ist dieser Wert auf truefestgelegt, wodurch die Client seitige Validierung aktiviert wird, wenn Sie vom Browser unterstützt wird.By default, this value is set to true, which enables client-side validation if the browser supports it. Sie können die Client seitige Validierung auf Steuerelement Basis deaktivieren.You can disable client-side validation on a control-by-control basis. Dies ist hilfreich, wenn die dynamische Aktualisierung auf dem Client Probleme mit dem Layout der Seite verursacht oder wenn Sie vor der Überprüfung einigen Servercode ausführen möchten.This is useful if dynamic updating on the client creates problems with the layout of the page, or if you want to execute some server code before validation takes place.

Diese Eigenschaft kann nicht durch Designs oder Stylesheetdesigns festgelegt werden.This property cannot be set by themes or style sheet themes. Weitere Informationen finden Sie unter ThemeableAttribute und ASP.NET-Designs und Skins.For more information, see ThemeableAttribute and ASP.NET Themes and Skins.

Gilt für:

Siehe auch