次の方法で共有

BaseValidator.IsValid プロパティ

  • [アーティクル]

関連付けられている入力コントロールの検証が成功したかどうかを示す値を取得または設定します。

名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)

構文

'宣言
<ThemeableAttribute(False)> _
Public Property IsValid As Boolean
'使用
Dim instance As BaseValidator
Dim value As Boolean

value = instance.IsValid

instance.IsValid = value

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

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

/** @property */
public final boolean get_IsValid ()

/** @property */
public final void set_IsValid (boolean value)

public final function get IsValid () : boolean

public final function set IsValid (value : boolean)

適用できません。

プロパティ値

関連付けられている入力コントロールの検証が成功した場合は true。それ以外の場合は false。既定値は true です。

解説

IsValid プロパティを使用して、関連付けられている入力コントロールの検証が成功したかどうかを確認します。

注意に関するメモ注意 :

このプロパティの既定値は true であるため、検証を実行する前にこのプロパティを照会すると、true が返されます。たとえば、ページの Control.Load イベントでこのプロパティを使用しようとすると、これが発生することがあります。

IsValid プロパティは、Validate メソッドが呼び出されたときにだけ評価されます。ページのそれぞれの検証コントロールについて個別に Validate メソッドを呼び出すか、Page.Validate メソッドを使用して、すべてのメソッドを一度に呼び出します。ボタン コントロールの CausesValidation プロパティが true に設定されていると、Page.Validate メソッドも呼び出されます。

メモメモ :

このプロパティの値は、検証の実行後に手動で変更できます。このため、必要に応じて検証結果をオーバーライドできます。

ページの Page.IsValid プロパティが true に設定されるのは、そのページの各検証コントロールの IsValid プロパティも true に設定されている場合だけです。

このプロパティをテーマ別またはスタイル シート テーマ別に設定することはできません。詳細については、ThemeableAttribute、ASP.NET のテーマとスキンの概要 の各トピックを参照してください。

使用例

IsValid プロパティを使用して、関連付けられている入力コントロールの検証が成功したかどうかを確認するコード例を次に示します。

セキュリティに関するメモセキュリティに関するメモ :

この例には、ユーザー入力を受け付けるテキスト ボックスがあります。これにより、セキュリティが脆弱になる可能性があります。既定では、ASP.NET Web ページによって、ユーザー入力にスクリプトまたは 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 NumberCompareValidator.IsValid And TextBoxRequiredValidator.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>

<%@ 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 (NumberCompareValidator.IsValid && TextBoxRequiredValidator.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>

プラットフォーム

Windows 98,Windows Server 2000 SP4,Windows CE,Windows Millennium Edition,Windows Mobile for Pocket PC,Windows Mobile for Smartphone,Windows Server 2003,Windows XP Media Center Edition,Windows XP Professional x64 Edition,Windows XP SP2,Windows XP Starter Edition

Microsoft .NET Framework 3.0 は Windows Vista,Microsoft Windows XP SP2,および Windows Server 2003 SP1 でサポートされています。

バージョン情報

.NET Framework

サポート対象 : 3.0,2.0,1.1,1.0

参照

関連項目

BaseValidator クラス
BaseValidator メンバ
System.Web.UI.WebControls 名前空間
BaseValidator.ControlToValidate プロパティ
Control.Load
Validate
Page.Validate
BaseValidator.IsValid プロパティ
Page.IsValid