ILSMARTLINKAGE

タイプを作成することで、連絡節とエントリポイントをマネージコードに公開します。

構文：

制約事項: This directive is supported for managed COBOL only.

>>-.---.-.-------ILSMARTLINKAGE---.-------------.--.--------><
   +-/-+ |                        +-"namespace"-+  |
         +-----NOILSMARTLINKAGE--------------------+

パラメーター：

namespace: 生成された各クラスがグループ化される名前空間

プロパティ：

デフォルト：	ILSMARTLINKAGE
フェーズ：	構文チェック
$SET：	初期
IDE での相当機能:	プロジェクトのプロパティで [COBOL] タブの [Expose group linkage items to managed code] をチェックします。

説明：

この指令は、グループリンケージ項目をマネージコードに公開します。COBOL プログラムで通常生成されるクラスの他に、この指令は実質的に連絡節ですべての 01 レベルグループ項目に 1 つのクラスを生成します。グループの各データ項目がこのクラスのプロパティとして公開され、ここでのプロパティは標準のマネージタイプです。

COBOL グループ項目は、文字列プロパティとして公開されます。グループに非 DISPLAY データ (数値 COMP 項目など) がある場合、グループに関連付けられたプロパティを非 DISPLAY 項目のポピュレートに使用することはできません。この場合、そのような非 DISPLAY 項目は、非 DISPLAY 項目に関連付けられた個別プロパティを使用してポピュレートする必要があります。

データ項目名からはハイフンが削除され、その削除されたハイフンに続く文字は大文字に変換されます。たとえば、データ項目 author-name は AuthorName に名前変更されます。

名前空間を指定すると、この指令の結果として生成されるすべてのクラスはその名前空間の下でグループ化されます。

ILSMARTLINKAGE を使用してコンパイルすると、追加のメソッドまたは .Reference というプロパティを含むクラスおよび型が生成されます。そのようなクラスまたは型を「参照渡し」で受け取るプログラムにパラメーターとして渡す場合、.Reference プロパティを指定して、「参照渡し」オブジェクトを使用する必要があります。これは、SmartLinkage パラメーターをカプセル化するオブジェクトを返すため、「参照渡し」によって宣言されているメソッドで使用されます。

また、.Reference を RunUnit:Call() メソッドで使用する必要があります。次に例を示します。

myRunUnit.Call("myprogram", myByRefParam.Reference);

例：

次の COBOL プログラムは、ILSMARTLINKAGE、ILCUTPREFIX(lnk-b-)、および ILCUTPREFIX(lnk-) でコンパイルされます。

       program-id. BookLegacy.
						 ...
       linkage section.
       01 lnk-function            pic x.
       01 lnk-b-details.
          03 lnk-b-text-details.
             05 lnk-b-title       pic x(50).
             05 lnk-b-type        pic x(20).
             05 lnk-b-author      pic x(50).
          03 lnk-b-stockno        pic x(4).
          03 lnk-b-retail         pic 99v99.
          03 lnk-b-onhand         pic 9(5).
          03 lnk-b-sold           pic 9(5) comp-3.
       procedure division using by value lnk-function
                                by reference lnk-b-details.

C# では、次のように .NET COBOL で BookLegacy プログラムのデータにアクセスできます。

    BookLegacy myBook = new BookLegacy(); 
         //creates an object corresponding to the BookLegacy program
    Details myDetails = new Details(); 
         //creates an instance corresponding to the group lnk-b-details 
    . . .          
       myDetails.Stockno = "6666";
       myDetails.Title = "Managed COBOL";
       myDetails.Author = "Mike Focus";
       myDetails.Type = "Reference";
       myDetails.Retail = 15.50M;
       myDetails.Onhand = 20;
       myDetails.Sold = 5;
       myBook.BookLegacy("2", myDetails);
         // calls the BookLegacy method with myDetails, 
         // which corresponds to the group item lnk-b-details

その他の例については、Visual COBOL サンプルで C# WinBook デモンストレーションを参照してください。