Freigeben über

BaseValidator.EnableClientScript-Eigenschaft

  • Artikel

Ruft einen Wert ab, der angibt, ob die Validierung auf dem Client aktiviert ist, oder legt diesen fest.

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
<ThemeableAttribute(False)> _
Public Property EnableClientScript As Boolean
'Usage
Dim instance As BaseValidator
Dim value As Boolean

value = instance.EnableClientScript

instance.EnableClientScript = value

[ThemeableAttribute(false)] 
public bool EnableClientScript { get; set; }

[ThemeableAttribute(false)] 
public:
property bool EnableClientScript {
    bool get ();
    void set (bool value);
}

/** @property */
public boolean get_EnableClientScript ()

/** @property */
public void set_EnableClientScript (boolean value)

public function get EnableClientScript () : boolean

public function set EnableClientScript (value : boolean)

Eigenschaftenwert

true, wenn die Validierung auf dem Client aktiviert ist, andernfalls false. Der Standardwert ist true.

Hinweise

Mit der EnableClientScript-Eigenschaft wird angegeben, ob die Validierung auf dem Client aktiviert ist.

Validierungssteuerelemente führen Validierungen immer auf dem Server durch. Sie verfügen außerdem über eine vollständige clientseitige Implementierung, sodass Browser mit DHTML-Unterstützung wie Microsoft Internet Explorer, Version 4.0 oder höher, die Validierung auf dem Client durchführen können. Durch die Validierung auf dem Client wird der Validierungsvorgang optimiert, indem Benutzereingaben vor dem Senden an den Server überprüft werden. Auf diese Weise werden Fehler auf dem Client vor dem Senden des Formulars entdeckt, wodurch der für die Validierung auf dem Server erforderliche Roundtrip vermieden wird.

Die Standardeinstellung für diesen Wert ist true und bedeutet, dass die Validierung auf dem Client aktiviert ist, sofern der Browser dies unterstützt. Sie können die Validierung auf dem Client für jedes einzelne Steuerelement deaktivieren. Diese Option ist nützlich, wenn das dynamische Aktualisieren auf dem Client zu Layoutproblemen auf der Seite führt oder wenn Sie Servercode vor der Validierung durchführen möchten.

Diese Eigenschaft kann nicht durch Designs oder Stylesheetdesigns festgelegt werden. Weitere Informationen finden Sie unter ThemeableAttribute und Übersicht über ASP.NET-Designs und ASP.NET-Skins.

Thema Position
Exemplarische Vorgehensweise: Validieren der Benutzereingabe in einer Web Forms-Seite Erstellen von ASP.NET-Webanwendungen in Visual Studio
Exemplarische Vorgehensweise: Validieren der Benutzereingabe in einer Web Forms-Seite Erstellen von Anwendungen mit Visual Web Developer

Beispiel

Im folgenden Codebeispiel wird veranschaulicht, wie mit der EnableClientScript-Eigenschaft die Validierung auf dem Client deaktiviert wird, sodass die Zufallszahlen auf dem Server generiert werden können.

<%@ Page Language="VB" AutoEventWireup="False" %>

<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>
  <body>
    <form 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>

<%@ Page Language="C#" %>

<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>
  <body>
    <form 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="JScript" %>

<script runat="server">
 
  function Button_Click(sender, e : EventArgs) 
  {
    if (Page.IsValid)
    {
      MessageLabel.Text = "Page submitted successfully.";
    }
    else
    {
      MessageLabel.Text = "There is an error on the page.";
    }
  }
 
</script>

<html>
  <body>
    <form 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>

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

BaseValidator-Klasse
BaseValidator-Member
System.Web.UI.WebControls-Namespace
DetermineRenderUplevel
RegisterValidatorCommonScript
RegisterValidatorDeclaration
RenderUplevel