CFEXIT  
説明

現在実行中の CFML カスタムタグの処理を中止します。また、現在実行中の CFML カスタムタグ内のページを終了するか、現在実行中の CFML カスタムタグ内のコードセクションを再実行します。

 
カテゴリ

デバッグタグ、フロー制御タグ

 
シンタックス
<cfexit
   method = "method">
 
関連項目

cfabort、cfbreak、cfexecute、cfif、cflocation、cfloop、cfswitch、cfthrow、cftry、『ColdFusion MX 開発ガイド』の第2章の「CFML の要素」 の「cfabort と cfexit」

 
使用方法

ベースページ内やインクルードページ内など、カスタムタグのコンテキスト外で cfexit タグが検出されると、cfabort と同様の処理が行われます。cfexit タグを使用すると、カスタムタグ内のエラーチェックと検証のための論理式を簡略化することができます。

cfexit タグの機能は、その位置と実行モードによって異なります。

method 属性の値 cfexit の呼び出し場所 動作

exitTag

ベースページ

処理を終了します。

 

Execution mode = Start

終了タグの後から処理を継続します。

 

Execution mode = End

終了タグの後から処理を継続します。

exitTemplate

ベースページ

処理を終了します。

 

Execution mode = Start

本文内の最初のサブタグから処理を継続します。

 

Execution mode = End

終了タグの後から処理を継続します。

loop

ベースページ

エラーになります。

 

Execution mode = Start

エラーになります。

 

Execution mode = End

本文内の最初のサブタグから処理を継続します。

 
<h3>cfexit の例</h3>
<p>cfexit を使用して、現在実行中の CFML カスタムタグの処理を中止することができます。カスタムタグを呼び出
したページ内のカスタムタグ呼び出しの後から実行が再開されます。
<h3>cfexit の使用方法</h3>
<p>cfexit は、主にカスタムタグの内部で処理の条件付き停止を行うときに使用します。cfexit は、カスタムタグ
を呼び出したページに制御を返します。このタグが他のタグから呼び出されている場合は、呼び出し元のタグに制
御を返します。

<!--- cfexit は、CFML カスタムタグ内で次のように使用できます。 --- --->
<!--- 該当するセクションのコメントを解除して、このコードを customtags ディレクトリ内に配置します。 --->

<!--- MyCustomTag.cfm --->
<!--- この簡単なカスタムタグを使用して、myValue1 と myValue2 が
存在するかどうかを調べます。値が 2 つとも定義されている場合は、
これらの値を追加して、変数 "result" の呼び出しページに
結果を返します。属性値がいずれか一方しか存在しないか、または両方とも存在しない場合は、
エラーメッセージが生成され、
CFEXIT によって呼び出しページに制御権が
返されます。 --->

<!--- <cfif NOT IsDefined("attributes.myValue2")>
         <cfset caller.result = "Value2 が定義されていません。">
         <cfexit method = "exitTag">
    <cfelseif NOT IsDefined("attributes.myValue1")>
         <cfset caller.result = "Value1 が定義されていません。">
         <cfexit method = "exitTag">
    <cfelse>
          <cfset value1 = attributes.myValue1>      
          <cfset value2 = attributes.myValue2>      
         <cfset caller.result = value1 + value2>
    </cfif> --->
<!--- MyCustomTag.cfm の終わり --->

<!--- このコードをページ内に指定 --->    

<!--- <p>カスタムタグの呼び出しとその結果
<CF_myCustomTag
      myvalue2 = 4>
<cfoutput>#result#</cfoutput> --->
<p>cfexit は、カスタムタグの外側で使用されると、cfabort のように機能します。 
たとえば、このメッセージの後ろのテキストは処理されません。
<cfexit>
<p>この上に cfexit タグがあるため、このテキストは実行されません。
METHOD  
  オプション
 
Default value: "exitTag"
  • exitTag: 現在実行中のタグの処理を中止します。
  • exitTemplate: 現在実行中のタグのページを終了します。
  • loop: 現在実行中のタグの本文を再実行します。