概要と準備

上述のように、動的組み込みクラスの実装と説明を同時に進めていく訳ですが、クラスの仕様が決まっていなければ実装することができません。

以下に、クラスの仕様を示します。

名前を fake とします。文字列操作クラスです。

内部データとして文字列を保持します。

初期化文字列によるフィッタを持ちます。

内部データにアクセスするためのセッタ、ゲッタを持ちます。

内部データと引数を連結するためのメソッドとインスタンスを未初期化状態に戻すメソッドを持ちます。

動的組み込みクラスのテンプレートをアーカイブとして用意してあります。

アーカイブ内の C# ソースファイルを追加、修正していくことで fake クラスを実装していきます。

以下にアーカイブ内の Rtemplate.cs を示します。

画像に示したように Rtemplate.cs を五つ部分に分けて、それぞれを独立したページで解説します。更にクラスの実際の登録を司る RtemplateEmbedder.cs についても独立したページで説明します。

アーカイブは以下のリンクからダウンロードして下さい。

ダウンロードされるアーカイブは 7z 形式の実行ファイルです。このファイルを実行すれば必要なファイルが解凍されます。

このドキュメントは Microsoft社の Visual Studio Community 2019 上で C#言語を利用することを前提しています。

C#ソースコードをアーカイブで配布していますが、これを Visual Studio で扱うためにはプロジェクトを作成しなければいけません。

Visual Studio を起動させて"新しいプロジェクトの作成"を選択してプロジェクトを作成します。作成するプロジェクトの種類は以下のとおりです。

クラスライブラリ

.NET Framework

C#

次に、プロジェクトの名前などを入力します。ここでは以下のように入力します。

プロジェクト名	Rfake
場所	任意の場所
ソリューション名	Rfake
フレームワーク	.NET Framework 4.6

これで新しいプロジェクトが作成されます。

まず、プロジェクトに Rice への参照を設定する必要があります。NuGet から最新の Rice をインストールします。ここでは x86 版をインストールしてください。

インストールした Rice の対象プラットフォームが x86 なのでプロジェクトの対象プラットフォームも x86 にする必要があります。

Rice 言語利用アプリケーションで使用する動的組み込みクラスのための .dll ファイルは以下の規則に従った名前を持たなければいけません。

.dll ファイルの名前は アセンブリ名を設定することで指定します。ここでは "Rtype.fake" を指定します。これで出来上がるファイルが "Rtype.fake.dll" になります。

プロジェクトにサンプルアーカイブのソースファイル(Rtemplate.cs, RtemplateEmbedder.cs)を読み込みます。