BaseValidator.EnableClientScript プロパティ

定義

クライアント側での検証を有効にするかどうかを示す値を取得または設定します。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

プロパティ値

クライアント側の検証が有効な場合は true。それ以外の場合は falsetrue 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 Web ページによって、ユーザー入力にスクリプトまたは 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 and ASP.NET theme And スキン」を参照してください。For more information, see ThemeableAttribute and ASP.NET Themes and Skins.

適用対象

こちらもご覧ください