ImageButton.CausesValidation プロパティとは何？わかりやすく解説 Weblio辞書

すべての辞書から再検索する

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

ImageButton.CausesValidation プロパティ

ImageButton コントロールがクリックされたときに検証を実行するかどうかを示す値を取得または設定します。

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

Visual Basic (宣言)

<ThemeableAttribute(False)> _
Public Overridable Property
 CausesValidation As Boolean

Visual Basic (使用法)

Dim instance As ImageButton
Dim value As Boolean

value = instance.CausesValidation

instance.CausesValidation = value

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

C++

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

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

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

JScript

public function get CausesValidation
 () : boolean

public function set CausesValidation
 (value : boolean)

プロパティ値
ImageButton コントロールがクリックされたときに検証を実行する場合は true。それ以外の場合は false。既定値は true です。

解説

既定では、ImageButton コントロールがクリックされたときにページ検証を実行します。ページ検証は、ページ上にある検証コントロールに関連付けられたすべての入力コントロールが、その検証コントロールによって指定されている検証規則に準拠しているかどうかを判断します。

CausesValidation プロパティを使用して、ImageButton コントロールがクリックされたときに、クライアントとサーバーの両方で検証を実行するかどうかを指定または決定できます。検証を実行しないようにするには、CausesValidation プロパティを false に設定します。

通常、このプロパティは、リセットボタンまたは消去ボタンがクリックされたときに検証が実行されないように、これらのボタンに対しては false に設定されます。

CausesValidation プロパティの値が true に設定されている場合は、ValidationGroup プロパティを使用して、ImageButton コントロールによって発生する検証の対象となる検証グループの名前を指定することもできます。

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

使用例

CausesValidation プロパティを使用して、ページ検証が実行されないようにする方法を次の例に示します。Validate メソッドが各検証コントロールを別々にアクティブにする方法に注目してください。

メモ
次のコードサンプルはシングルファイルコードモデルを使用しており、分離コードファイルに直接コピーされた場合は正常に動作しない可能性があります。このコードサンプルは、拡張子が .aspx の空のテキストファイルにコピーする必要があります。Web フォームのコードモデルの詳細については、「ASP.NET Web ページのコードモデル」を参照してください。

メモ

次のコードサンプルはシングルファイルコードモデルを使用しており、分離コードファイルに直接コピーされた場合は正常に動作しない可能性があります。このコードサンプルは、拡張子が .aspx の空のテキストファイルにコピーする必要があります。Web フォームのコードモデルの詳細については、「ASP.NET Web ページのコードモデル」を参照してください。

Visual Basic

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

<html> 

<head>

   <script runat="server">

      Sub SubmitButton_Click(sender As Object,
 e As ImageClickEventArgs)
         
         ' Determine which button was clicked.
         Select Case (CType(sender, ImageButton)).ID

            Case "CityQueryButton"

               ' Validate only the controls used for the city query.
               CityReqValidator.Validate()

               ' Take the appropriate action if the controls pass validation.
 
               If CityReqValidator.IsValid Then
           
                  Message.Text = "You have chosen to run a query
 for the following city: " & _ 
                     CityTextBox.Text
               
               End If

            Case "StateQueryButton"

               ' Validate only the controls used for the state query.
               StateReqValidator.Validate()

               ' Take the appropriate action if the controls pass validation.
               If StateReqValidator.IsValid Then
               
                  Message.Text = "You have chosen to run a query
 for the following state: " & _ 
                     StateTextBox.Text
               
               End If

            Case Else

               ' If the button clicked isn't recognized, erase the message
 on the page.
               Message.Text = ""

         End Select
        
      End Sub

   </script>

</head>

<body>

   <form runat="server">

      <h3> ImageButton CausesValidation Example </h3>

      <table border="1" cellpadding="10">
         <tr>
            <td>
               <b>Enter city to query.</b> <br>
               <asp:TextBox ID="CityTextBox" 
                    runat="server"/>
               <asp:RequiredFieldValidator ID="CityReqValidator"
                    ControlToValidate="CityTextBox"
                    ErrorMessage="<br>Please enter a city."
                    Display="Dynamic"
                    EnableClientScript="False"
                    runat="server"/>
            </td>
            <td valign="bottom">
               <asp:ImageButton ID="CityQueryButton"
                    ImageUrl="SubmitImage.jpg"
                    CausesValidation="False"
                    OnClick="SubmitButton_Click"
                    runat="server"/>
            </td>
         </tr>

         <tr>
            <td>
               <b>Enter state to query.</b> <br>
               <asp:TextBox ID="StateTextBox" 
 
                    runat="server"/>
               <asp:RequiredFieldValidator ID="StateReqValidator"
                    ControlToValidate="StateTextBox"
                    ErrorMessage="<br>Please enter a state."
                    Display="Dynamic"
                    EnableClientScript="False"
                    runat="server"/>
            </td>
            <td valign="bottom">
               <asp:ImageButton ID="StateQueryButton"
                    ImageUrl="SubmitImage.jpg"
                    CausesValidation="False"
                    OnClick="SubmitButton_Click"
                    runat="server"/>
            </td>
         </tr>

      </table>

      <br><br>

      <asp:Label ID="Message"
           runat="Server"/>

   </form>

</body>
</html>

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

<html> 

<head>

   <script runat="server">

      void SubmitButton_Click(Object sender, ImageClickEventArgs
 e)
      {
         
         // Determine which button was clicked.
         switch(((ImageButton)sender).ID)
         {

            case "CityQueryButton":

               // Validate only the controls used for the city query.
               CityReqValidator.Validate();

               // Take the appropriate action if the controls pass validation.
 
               if (CityReqValidator.IsValid)
               {
                  Message.Text = "You have chosen to run a query for
 the following city: " + 
                     CityTextBox.Text;
               }

               break;

            case "StateQueryButton":

               // Validate only the controls used for the state query.
               StateReqValidator.Validate();

               // Take the appropriate action if the controls pass validation.
               if (StateReqValidator.IsValid)
               {
                  Message.Text = "You have chosen to run a query for
 the following state: " + 
                     StateTextBox.Text;
               }

               break;

            default:

               // If the button clicked isn't recognized, erase the
 message on the page.
               Message.Text = "";

               break;

         }
        
      }

   </script>

</head>

<body>

   <form runat="server">

      <h3> ImageButton CausesValidation Example </h3>

      <table border="1" cellpadding="10">
         <tr>
            <td>
               <b>Enter city to query.</b> <br>
               <asp:TextBox ID="CityTextBox" 
                    runat="server"/>
               <asp:RequiredFieldValidator ID="CityReqValidator"
                    ControlToValidate="CityTextBox"
                    ErrorMessage="<br>Please enter a city."
                    Display="Dynamic"
                    EnableClientScript="False"
                    runat="server"/>
            </td>
            <td valign="bottom">
               <asp:ImageButton ID="CityQueryButton"
                    ImageUrl="SubmitImage.jpg"
                    CausesValidation="False"
                    OnClick="SubmitButton_Click"
                    runat="server"/>
            </td>
         </tr>

         <tr>
            <td>
               <b>Enter state to query.</b> <br>
               <asp:TextBox ID="StateTextBox"  
                    runat="server"/>
               <asp:RequiredFieldValidator ID="StateReqValidator"
                    ControlToValidate="StateTextBox"
                    ErrorMessage="<br>Please enter a state."
                    Display="Dynamic"
                    EnableClientScript="False"
                    runat="server"/>
            </td>
            <td valign="bottom">
               <asp:ImageButton ID="StateQueryButton"
                    ImageUrl="SubmitImage.jpg"
                    CausesValidation="False"
                    OnClick="SubmitButton_Click"
                    runat="server"/>
            </td>
         </tr>

      </table>

      <br><br>

      <asp:Label ID="Message"
           runat="Server"/>

   </form>

</body>
</html>

プラットフォーム

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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
ImageButton クラス
ImageButton メンバ
System.Web.UI.WebControls 名前空間
Page.Validate
ValidationGroup
その他の技術情報
ImageButton Web サーバーコントロールの宣言構文
Button Web サーバーコントロールの概要

このページでは「.NET Framework クラスライブラリリファレンス」からImageButton.CausesValidation プロパティを検索した結果を表示しています。
Weblioに収録されているすべての辞書からImageButton.CausesValidation プロパティを検索する場合は、下記のリンクをクリックしてください。

全ての辞書からImageButton.CausesValidation プロパティを検索

>> 「ImageButton.CausesValidation プロパティ」を含む用語の索引
ImageButton.CausesValidation プロパティのページへのリンク

ImageButton.CausesValidation プロパティとは？わかりやすく解説

ImageButton.CausesValidation プロパティ

「ImageButton.CausesValidation プロパティ」の関連用語


	© 2024 Microsoft.All rights reserved.

ImageButton.CausesValidation プロパティとは？ わかりやすく解説

ImageButton.CausesValidation プロパティ

急上昇のことば

「ImageButton.CausesValidation プロパティ」の関連用語

ImageButton.CausesValidation プロパティとは？わかりやすく解説