TextBox.CausesValidation プロパティ

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

TextBox.CausesValidation プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

ポストバックの発生時に検証を実行するように TextBox コントロールを設定した場合に検証を実行するかどうかを示す値を取得または設定します。

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

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim instance As TextBox
Dim value As Boolean

value = instance.CausesValidation

instance.CausesValidation = value

C#

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

C++

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

J#

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

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

JScript

public function get CausesValidation
 () : boolean

public function set CausesValidation
 (value : boolean)

プロパティ値
ポストバックの発生時に検証を実行するように TextBox コントロールを設定し、検証を実行する場合は true。それ以外の場合は false。既定値は false です。

解説

CausesValidation プロパティを使用して、ポストバックの発生時に検証を実行するように TextBox コントロールを設定した場合に、クライアント側とサーバー側の両方で検証が実行されるかどうかを確認します。ページ検証は、ページ上にある検証コントロールに関連付けられたすべての入力コントロールが、その検証コントロールによって指定されている検証規則に準拠しているかどうかを判断します。

既定では、TextBox コントロールがフォーカスを失うとページ検証は実行されません。ポストバックの発生時に検証を実行するように TextBox コントロールを設定するには、CausesValidation プロパティを true に設定し、AutoPostBack プロパティを true に設定します。

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

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

プラットフォーム

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

参照

関連項目
TextBox クラス
TextBox メンバ
System.Web.UI.WebControls 名前空間
Validate
CheckBox.ValidationGroup プロパティ
その他の技術情報
TextBox Web サーバー コントロール