BaseValidator.EnableClientScript Proprietà

Definizione

Ottiene o imposta un valore che indica se la convalida sul client è abilitata.Gets or sets a value indicating whether client-side validation is enabled.

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
Public Property EnableClientScript As Boolean

Valore della proprietà

true se la convalida sul client è abilitata; in caso contrario, false.true if client-side validation is enabled; otherwise, false. Il valore predefinito è true.The default value is true.

Attributi

Esempio

Nell'esempio di codice riportato di seguito viene illustrato come utilizzare la proprietà EnableClientScript per disabilitare la convalida lato client in modo che sia possibile generare numeri casuali sul server.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.

Importante

L'esempio include una casella di testo che accetta l'input dell'utente e rappresenta quindi una potenziale minaccia alla sicurezza.This example has a text box that accepts user input, which is a potential security threat. Per impostazione predefinita, le pagine Web ASP.NET verificano che l'input dell'utente non includa script o elementi HTML.By default, ASP.NET Web pages validate that user input does not include script or HTML elements. Per altre informazioni, vedere Cenni preliminari sugli attacchi tramite script.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>

Commenti

Utilizzare la proprietà EnableClientScript per specificare se la convalida sul lato client è abilitata.Use the EnableClientScript property to specify whether client-side validation is enabled.

I controlli di convalida eseguono sempre la convalida nel server.Validation controls always perform validation on the server. Dispongono inoltre di un'implementazione completa sul lato client che consente ai browser supportati da DHTML, ad esempio Microsoft Internet Explorer 4,0 e versioni successive, di eseguire la convalida nel client.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. La convalida lato client migliora il processo di convalida controllando l'input dell'utente prima che venga inviato al server.Client-side validation enhances the validation process by checking user input before it is sent to the server. In questo modo è possibile rilevare gli errori sul client prima dell'invio del modulo, evitando la round trip delle informazioni necessarie per la convalida sul lato 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.

Per impostazione predefinita, questo valore è impostato su true, che Abilita la convalida sul lato client se supportata dal browser.By default, this value is set to true, which enables client-side validation if the browser supports it. È possibile disabilitare la convalida lato client in base al controllo.You can disable client-side validation on a control-by-control basis. Questa operazione è utile se l'aggiornamento dinamico nel client crea problemi con il layout della pagina o se si desidera eseguire codice server prima che venga eseguita la convalida.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.

Questa proprietà non può essere impostata da temi oppure temi di fogli di stile.This property cannot be set by themes or style sheet themes. Per ulteriori informazioni, vedere i temi e le interfaccedi ThemeableAttribute e ASP.NET.For more information, see ThemeableAttribute and ASP.NET Themes and Skins.

Si applica a

Vedi anche