Page.IsValid プロパティ

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

Page.IsValid プロパティ

ページ検証が成功したかどうかを示す値を取得します。

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

Visual Basic (宣言)

Public ReadOnly Property
 IsValid As Boolean

Visual Basic (使用法)

Dim instance As Page
Dim value As Boolean

value = instance.IsValid

C#

public bool IsValid { get;
 }

C++

public:
property bool IsValid {
    bool get ();
}

J#

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

JScript

public function get IsValid
 () : boolean

プロパティ値
ページ検証が成功した場合は true。それ以外の場合は false。

解説

このプロパティが true を返すには、現在の検証グループのすべての検証サーバー コントロールで検証が成功する必要があります。このプロパティを確認する必要があるのは、Page.Validate メソッドを呼び出した後、またはフォーム処理を開始する ASP.NET サーバー コントロールの OnServerClick イベント ハンドラで CausesValidation プロパティを true に設定した後だけです。これらのサーバー コントロールには Button、HtmlButton、HtmlInputButton、HtmlInputImage、ImageButton、LinkButton の各クラスがあります。

Validate メソッドを使用して検証グループの検証を強制的に実行している場合は、指定した検証グループのすべての検証コントロールでも検証が成功する必要があります。

Topic	Location
チュートリアル : Web フォーム ページにおけるユーザーの入力の検証	Visual Studio での ASP .NET Web アプリケーションの作成
方法 : ASP.NET サーバー コントロールに必要なエントリを検証する	ASP .NET Web アプリケーションの作成
方法 : ASP.NET サーバー コントロールのカスタム検証メッセージを表示する	ASP .NET Web アプリケーションの作成
方法 : ASP.NET サーバー コントロールのデータベースの値を検証する	ASP .NET Web アプリケーションの作成
方法 : ASP.NET サーバー コントロールのデータ型を検証する	ASP .NET Web アプリケーションの作成
方法 : ASP.NET サーバー コントロールのパターンに対して検証する	ASP .NET Web アプリケーションの作成
方法 : ASP.NET サーバー コントロールの値の範囲を検証する	ASP .NET Web アプリケーションの作成
方法 : ASP.NET サーバー コントロールの固有の値を検証する	ASP .NET Web アプリケーションの作成
方法 : ASP.NET サーバー コントロールの埋め込み先メッセージのレイアウトを指定する	ASP .NET Web アプリケーションの作成
方法 : ASP.NET サーバー コントロールの有効性をプログラムでテストする	ASP .NET Web アプリケーションの作成
方法 : ASP.NET サーバー コントロールの検証エラー メッセージの書式を設定する	ASP .NET Web アプリケーションの作成
方法 : ASP.NET サーバー コントロールの検証を無効にする	ASP .NET Web アプリケーションの作成
方法 : ASP.NET サーバー コントロールをカスタム関数で検証する	ASP .NET Web アプリケーションの作成
方法 : ASP.NET サーバー コントロールをプログラムで検証する	ASP .NET Web アプリケーションの作成

使用例

IsValid プロパティを使用して条件付きステートメントを設定する方法を次のコード例に示します。プロパティが true を返す場合は、lblOutput コントロールの Text プロパティが "Page is valid!" に設定されます。それ以外の場合は "Some of the required fields are empty" に設定されます。

Visual Basic

Sub ValidateBtn_Click(sender As Object,
 e As EventArgs)

   If (Page.IsValid) Then
      lblOutput.Text = "Page is Valid!"
   Else
      lblOutput.Text = "Some of the required fields are empty."
   End If

End Sub

C#

 void ValidateBtn_Click(Object Sender, EventArgs E) {

    if (Page.IsValid == true) {
       lblOutput.Text = "Page is Valid!";
    }
    else {
       lblOutput.Text = "Some of the required fields are empty.";
    } 
}

JScript

 function ValidateBtn_Click(Sender, e : EventArgs) {

    if (Page.IsValid == true) {
       lblOutput.Text = "Page is Valid!";
    }
    else {
       lblOutput.Text = "Some of the required fields are empty";
    } 
}

プラットフォーム

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

参照

関連項目
Page クラス
Page メンバ
System.Web.UI 名前空間
Validators
ValidatorCollection
Validate