GETMETADATA | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
説明
ColdFusion server に配置されるオブジェクトに割り当てられたメタデータ (コンポーネントのメソッド、プロパティ、パラメータなど) を取得します。 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
戻り値
構造化されたメタデータ情報 : ColdFusion コンポーネント (CFC) およびユーザー定義関数の場合は、構造体。クエリーオブジェクトの場合は、構造体の配列。 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
カテゴリ
システム関数 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
関数のシンタックスGetMetaData(object) |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
関連項目
CreateObject、QueryAddColumn、QueryNew |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ヒストリ
ColdFusion MX 7: クエリーオブジェクトのメタデータを取得できるようになりました。 ColdFusion MX: この関数が追加されました。 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
パラメータ
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
使用方法
この関数は、アプリケーションデータに関する情報を提供し、オブジェクトの構造体およびその使用方法をアプリケーションでダイナミックに確定できるようにします。この関数は、CFC およびクエリーオブジェクトに役立ちます。CFC のメタデータは、コンポーネントに関する情報、その関数、引数、およびプロパティに関する情報などです。getMetaData 関数は、CFC の一部ではないユーザー定義関数のメタデータも返します。 次の表に、この関数によって返されるデータを、サポートされるオブジェクトタイプ別に示します。
詳細については、『ColdFusion MX 開発ガイド』の第10章の「ColdFusion コンポーネントの作成と使用」 の「インストロスペクションによるコンポーネント情報の取得」を参照してください。 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
例
次の例では、cfdump タグを使用して、ColdFusion コンポーネントブラウザで使用するユーティリティ CFC のメタデータを表示します。cfdocexamples データベースの Employees テーブル内のフィールドの名前とデータタイプも表示します。 <!--- Component Explorer ユーティリティ CFC のインスタンスを作成して そのメタデータを取得 ---> <cfscript> componentutils = createObject("component", "cfide.componentutils.utils"); utilmetadata = getMetaData(componentutils); </cfscript> <h4>CFC コンポーネントユーティリティのメタデータ</h4> <cfdump var="#utilmetadata#"> <!--- GetMetadata を使用して、cfdocexamples データベースの Employees テーブル内のフィールドの名前と データタイプを取得 ---> <cfquery name="getemployees" datasource="cfdocexamples"> SELECT * FROM Employees </cfquery> <cfset employeemeta=getMetaData(getemployees)> <h4>Employees テーブル内の列</h4> <cfloop index="i" from="1" to="#arrayLen(employeemeta)#"> <cfoutput> #employeemeta[i].name# #employeemeta[i].TypeName# #employeemeta[i].isCaseSensitive#<br> </cfoutput> </cfloop> |
OBJECT | |
ColdFusion コンポーネント、ユーザー定義関数、またはクエリーオブジェクトです。 CFC 内で、パラメータを使用して This スコープを指定することもできます。 |