BaseValidator.EnableClientScript BaseValidator.EnableClientScript BaseValidator.EnableClientScript BaseValidator.EnableClientScript Property

Определение

Получает или задает значение, показывающее, включена ли проверка на стороне клиента.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

Значение свойства

Значение true, если проверка на стороне клиента включена; в противном случае — значение false.true if client-side validation is enabled; otherwise, false. Значение по умолчанию — true.The default value is true.

Примеры

В следующем примере кода показано, как использовать EnableClientScript свойство для отключения проверки на стороне клиента, чтобы случайные числа могли быть созданы на сервере.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.

Важно!

В этом примере имеется текстовое поле, принимающее вводимые пользователем данные, что является потенциальной угрозой безопасности.This example has a text box that accepts user input, which is a potential security threat. По умолчанию данные, вводимые пользователем на веб-страницах ASP.NET, проверяются на наличие скриптов и HTML-элементов.By default, ASP.NET Web pages validate that user input does not include script or HTML elements. Дополнительные сведения см. в разделе Общие сведения об использовании сценариев.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>

Комментарии

EnableClientScript Используйте свойство, чтобы указать, включена ли проверка на стороне клиента.Use the EnableClientScript property to specify whether client-side validation is enabled.

Проверяющие элементы управления всегда выполняют проверку на сервере.Validation controls always perform validation on the server. Они также имеют полную реализацию на стороне клиента, которая позволяет браузерам, поддерживающим DHTML (например, Microsoft Internet Explorer 4,0 и более поздние версии), выполнять проверку на клиенте.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. Проверка на стороне клиента улучшает процесс проверки, проверяя ввод пользователя перед его отправкой на сервер.Client-side validation enhances the validation process by checking user input before it is sent to the server. Это позволяет обнаруживать ошибки на клиенте перед отправкой формы, избегая циклической обработки информации, необходимой для проверки на стороне сервера.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.

По умолчанию это значение равно, что trueпозволяет выполнять проверку на стороне клиента, если она поддерживается браузером.By default, this value is set to true, which enables client-side validation if the browser supports it. Проверку на стороне клиента можно отключить для каждого элемента управления.You can disable client-side validation on a control-by-control basis. Это полезно, если динамическое обновление на клиенте создает проблемы с макетом страницы или если требуется выполнить некоторый серверный код перед проверкой.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.

Значение для данного свойства нельзя задать с помощью тем или тем таблиц стилей.This property cannot be set by themes or style sheet themes. Дополнительные сведения см ThemeableAttribute . в статьях и ASP.NET Themes и обложки.For more information, see ThemeableAttribute and ASP.NET Themes and Skins.

Применяется к

Дополнительно