4.7.1 サンプルプログラムの使用方法
Client .NETのサンプルプログラムのディレクトリ構成,ビルド方法および実行手順を説明します。なお,以降の説明で,%DCCLNDIR%はClient .NETのインストールディレクトリを示します。
(1) ディレクトリ構成
Client .NETのサンプルプログラムは,次の表に示すディレクトリに格納されています。
ディレクトリ |
説明 |
---|---|
%DCCLNDIR%\examples |
Client .NETのサンプルプログラム格納ディレクトリ |
%DCCLNDIR%\examples\C# |
C#のサンプルプログラム格納ディレクトリ |
%DCCLNDIR%\examples\VB.NET |
Visual Basicのサンプルプログラム格納ディレクトリ |
各言語のサンプルプログラム格納ディレクトリ下は,次の表に示す名称のディレクトリで構成されます。それぞれのディレクトリの名称と,格納されているサンプルプログラムの種類について,開発言語別に次の表に示します。
名称 |
説明 |
---|---|
RPC要求インタフェースとしてバイナリデータを使用したCUP.NETです。 このサンプルプログラムでは,クライアントスタブを使用しません。 |
|
RPC要求インタフェースとしてサービス定義から生成されたクライアントスタブとカスタムレコードを使用したCUP.NETです。 |
|
RPC要求インタフェースとして.NETインタフェース定義から生成されたクライアントスタブを使用したCUP.NETです。 |
(2) サンプルプログラムのビルド方法
Client .NETのサンプルプログラムをビルドする手順を説明します。
(a) サンプルプログラムをビルドするための準備
-
次のコマンドプロンプトを起動します。
-
C#,およびVisual Basicの場合
Visual Studioが提供するコマンドプロンプト,または.NET Framework SDKが提供するコマンドプロンプト
-
-
環境変数DCCLNDIRに,Client .NETのインストールディレクトリを設定します。
- 【例】
-
set DCCLNDIR=C:\Program Files\HITACHI\TP1Client for .NET Framework
(b) サンプルプログラムをまとめてビルドする方法
サンプルプログラムをまとめてビルドする方法は,どの開発言語のサンプルプログラムをビルドするかによって異なります。それぞれの場合に分けて方法を示します。
-
C#,およびVisual Basicのサンプルプログラムをまとめてビルドする場合
%DCCLNDIR%\examples\build_all.batを実行します。
-
言語別にサンプルプログラムをまとめてビルドする場合
-
C#の場合
%DCCLNDIR%\examples\C#\build_cs.batを実行します。
-
Visual Basicの場合
%DCCLNDIR%\examples\VB.NET\build_vb.batを実行します。
-
(c) サンプルプログラムを個別にビルドする方法
各サンプルプログラム格納ディレクトリ下のbuild.batを実行します。
- 【例】Visual BasicのCUPIFサンプルの場合
-
%DCCLNDIR%\examples\VB.NET\CUPIF\build.bat
(3) サンプルプログラムの実行手順
Client .NETのサンプルプログラムの実行手順を説明します。
(a) SPP.NETのサンプルプログラムの起動
各サンプルプログラムを実行するためには,Extension .NETのサンプルプログラムのうち,各サンプルプログラムが利用するSPP.NETを起動します。各サンプルプログラムが利用するSPP.NETを次の表に示します。
サンプルプログラムの種類 |
利用するSPP.NET |
ユーザサーバ名 |
---|---|---|
C#\CUPBIN |
C#\SPPBIN |
CSSPPBIN |
C#\CUPCR |
C#\SPPBIN |
CSSPPBIN |
C#\CUPIF |
C#\SPPIF |
CSSPPIF |
VB.NET\CUPBIN |
VB.NET\SPPBIN |
VBSPPBIN |
VB.NET\CUPCR |
VB.NET\SPPBIN |
VBSPPBIN |
VB.NET\CUPIF |
VB.NET\SPPIF |
VBSPPIF |
SPP.NETの起動方法については,マニュアル「TP1/Extension for .NET Framework 使用の手引」を参照してください。
(b) 構成ファイルの変更
利用するOpenTP1サーバ環境に応じて,構成ファイルのClient .NET構成定義を変更します。例えば,Visual BasicのCUPIFサンプルで,OpenTP1のホスト名やネームサービスのポート番号などを変更する場合は,%DCCLNDIR%\examples\VB.NET\CUPIF\VBCUPIF.exe.configファイルのtp1Server要素,rpc要素およびnameService要素を変更します。
(c) CUP.NETの実行
ビルドされたCUP.NETのアセンブリを実行します。
- 【例】Visual BasicのCUPIFサンプルの場合
-
%DCCLNDIR%\examples\VB.NET\CUPIF\VBCUPIF.exe