CFOBJECT: COM オブジェクト | |||
説明
COM (Component Object Model) オブジェクトを作成および操作します。また、登録されている自動サーバーオブジェクトタイプを呼び出します。 OLEView、COM、および DCOM については、Microsoft OLE 開発 Web サイト www.microsoft.com を参照してください。 このタグを使用するには、オブジェクトのプログラム ID またはファイル名、IDispatch インターフェイスから利用できるメソッドとプロパティ、およびオブジェクトのメソッドの引数と戻り値のタイプを指定する必要があります。ほとんどの COM オブジェクトについて、OLEView ユーティリティを使用してこの情報を得ることができます。
| |||
シンタックス<cfobject type = "com" action = "action" class = "program_ID" name = "text" context = "context" server = "server_name"> |
|||
関連項目
ReleaseComObject、cfcollection、cfexecute、『ColdFusion MX 開発ガイド』の第17章の「グローバル化アプリケーションの開発」 の「COM」
|
|||
例<h3>cfobject (COM) の例</h3> <!--- COM オブジェクトを inproc サーバー (DLL) として作成 (class = prog-id)---> <cfobject action = "Create" type = "COM" class = Macromedia.DocEx1.1 name = "obj"> <!--- メソッドを呼び出す。引数を指定しないメソッドは、空の括弧を使用して呼び出します。 ---> <cfset obj.Init()> <!--- これはコレクションオブジェクトです。少なくとも、次の値がサポートされている必要があります。 プロパティ:Count メソッド:Item(inarg, outarg) _NewEnum と呼ばれる特別なプロパティ ---> <cfoutput> このオブジェクトには、#obj.Count# 個の項目があります。 <br> <HR> </cfoutput> <!--- コレクション内の 3 番めのオブジェクトを取得 ---> <cfset emp = obj.Item(3)> <cfoutput> 3 番めの項目の姓は #emp.lastname# です。 <br> <HR> </cfoutput> <!---コレクション内のすべてのオブジェクトに対してループ ---> <p>コレクション内のすべてのオブジェクトに対するループ。 <br> <cfloop collection = #obj# item = file2> <cfoutput> 姓。#file2.lastname# <br></cfoutput> </cfloop> |
TYPE | |
オプション | |
オブジェクトタイプです。
その他のオブジェクトタイプは、type 属性を取りません。 |
ACTION | |
必須 | |
|
CLASS | |
必須 | |
呼び出すオブジェクトのコンポーネントプログラム ID です。Java スタブを使用して COM オブジェクトに接続するときは、class に COM オブジェクトのプログラム ID を指定する必要があります。 |
NAME | |
必須 | |
文字列です。インスタンス化されたコンポーネント名を指定します。 |
CONTEXT | |
オプション | |
Windows では、指定しない場合、Registry 設定が使用されます。 |
SERVER | |
context = "Remote" の場合は必須 | |
サーバー名です。Universal Naming Convention (UNC) または Domain Name Serve (DNS) の表記規則を使用して、次のいずれかの形式で指定します。
|