ISVALID  
説明

値が検証やデータタイプのルールに準拠しているかどうかをテストします。

 
戻り値

値がルールに準拠している場合は true、準拠していない場合は false

 
カテゴリ

決定関数

 
関数のシンタックス
IsValid(type, value)
isValid("range", value, min, max) 
isValid("regex" or "regular_expression", value, pattern)
 
関連項目

cfparam、cfform、IsBoolean、IsDate、IsNumeric、IsSimpleValue、『ColdFusion MX 開発ガイド』の第28章の「データの検証」 の「IsValid 関数および cfparam タグによるデータの検証」

 
ヒストリ

ColdFusion MX 7: この関数が追加されました。

 
パラメータ

 
使用方法

IsValid 関数を使用することにより、検証を必ずサーバー上で実行するようにします。cfparam タグを使用して、同様に検証を実行することができます。

 

次の例では、ユーザーが数値 ID および有効な電子メールアドレスと電話番号を送信したかどうかを確認します。送信された値のいずれかが検証テストの基準を満たさない場合は、エラーメッセージが表示されます。

<cfif isDefined("form.saveSubmit")>
   <cfif isValid("integer", form.UserID) and isValid("email", form.emailAddr) 
         and isValid("telephone", form.phoneNo)>
      <cfoutput>
         <!--- データベースを更新するアプリケーションコードがここに入る --->
         <h3>ユーザー #Form.UserID# の電子メールアドレスと電話番号が 
            追加されました。</h3>
      </cfoutput>
   <cfelse>
      <H3>有効なユーザー ID、電話番号、電子メールアドレスを指定する必要があります。</H2>
   </cfif>
   <cfelse>
</cfif>

<cfform action="#CGI.SCRIPT_NAME#">
   ユーザー ID :<cfinput type="Text" name="UserID"><br>
   電話番号 :<cfinput type="Text" name="phoneNo"><br>
   電子メール :<cfinput type="Text" name="emailAddr"><br>
   <cfinput type="submit" name="saveSubmit" value="Save Data"><br>
</cfform>
type 有効なデータの形式です。次のいずれかです。検証アルゴリズムに関する情報の詳細については、 『ColdFusion MX 開発ガイド』の第28章の「データの検証」 の「非表示フィールドによるフォー ムデータの検証」を参照してください。 value テスト対象の値です。 min 最小有効値です。range の検証の場合にのみ使用します。 max 最大有効値です。range の検証の場合にのみ使用します。 pattern パラメータ表記の基準となる JavaScript 正規表現です。regex または regular_expression の検証 の場合にのみ使用します。