.NET の構成と要件

要件

• サポート対象バージョンの .NET または .NET Framework

• Visual Studio 2013 以降

.NET クライアント・アプリケーションを実行するコンピュータには InterSystems IRIS は不要です。ただし、クライアントでは、インターシステムズ・サーバへの TCP/IP 接続が可能であること、およびサポート対象バージョンの .NET または .NET Framework を実行していることが必要です。

IRISClient アセンブリのセットアップ

IRISClient アセンブリ (InterSystems.Data.IRISClient.dll) は、InterSystems IRIS の他のコンポーネントと共にインストールされます。特別な準備は必要ありません。

• Windows では、InterSystems IRIS をインストールするときに Setup Type: Development オプションを選択します。

• InterSystems IRIS をセキュリティ・オプション 2 でインストールした場合、管理ポータルを開いて、System Administration > Security > Services に移動し、%Service_CallIn を選択して、[サービス有効] ボックスにチェックが付いていることを確認します。InterSystems IRIS をセキュリティ・オプション 1 (最小) でインストールした場合、これには既にチェックが付いているはずです。

.NET プロジェクトで IRISClient アセンブリを使用するには、このアセンブリへの参照を追加して、対応する Using 文をコードに追加する必要があります (次のセクションを参照)。

サポート対象の .NET および .NET Framework のバージョンごとに、個別の InterSystems.Data.IRISClient.dll のバージョンがあります。詳細は、“サポート対象の .NET バージョン” を参照してください。

システム要件

InterSystems IRIS で Entity Framework Provider を使用するには、以下のソフトウェアが必要になります。

• Visual Studio 2013 以降 (最初のサポート対象リリースは、Update 5 が適用された VS 2013 Professional/Ultimate)。

• サポート対象バージョンの .NET Framework (.NET Core 以降の .NET バージョンはサポートされていません)。

• InterSystems IRIS Entity Framework Provider のディストリビューション (次のセクションで説明します)。

IrisEF ディレクトリの作成

InterSystems IRIS Entity Framework Provider のディストリビューション・ファイルは、install-dir\dev\dotnet\bin\v4.0.30309 にある IrisEF.zip です。

1. install-dir\dev\dotnet\bin\v4.0.30309\IrisEF という名前の新しいディレクトリを作成します。

2. IrisEF.zip のコンテンツを新しいディレクトリに抽出します。

この .zip ファイルには、設定手順で使用する以下のファイルが含まれています。

• setup.cmd — DLL InterSystems.Data.IRISClient.dll および InterSystems.Data.IRISVSTools.dll をインストールします。

• Nuget\InterSystems.Data.Entity6.4.5.0.0.nupkg — Entity Framework Provider をインストールします。

• CreateNorthwindEFDB.sql — サンプル・データベースの作成に使用されます (“サンプル・データベースの設定” を参照)。

Visual Studio の構成と EF プロバイダのインストール

1. 新しい IrisEF ディレクトリに移動します。次の手順では、IrisEF を現在のディレクトリと想定しています。

2. Visual Studio 開発環境を設定します。

   • Windows で、すべてのプログラム > Visual Studio 201x > Visual Studio Tools を選択します。

   • 表示された Windows エクスプローラ・フォルダで Developer Command Prompt for VS201x > 管理者として実行 を右クリックして、以下を入力します。

     devenv /setup
     

     

   このコマンドは、お使いのバージョンの Visual Studio へのパスを指定するレジストリ・キーから環境設定を再生成します。

3. コマンド・プロンプトで、setup.cmd を実行します。これにより、InterSystems Entity Framework Provider ファイル、InterSystems.Data.IRISClient.dll と InterSystems.Data.IRISVSTools.dll がインストールされます。

Visual Studio へのファイルのコピー

IrisEF サブディレクトリ IrisEF\Templates から Visual Studio に以下のファイルをコピーします。

• SSDLToIrisSQL.tt

• GenerateIrisSQL.Utility.ttinclude

<iris-install-dir>\dev\dotnet\bin\v4.0.30319\IrisEF\Templates から

<VisualStudio-install-dir>\Common7\IDE\Extensions\Microsoft\Entity Framework Tools\DBGen にコピーします。

サーバへの Visual Studio の接続

インターシステムズ・データベース・インスタンスに Visual Studio を接続するには、以下の手順を実行します。

1. Visual Studio を開いて、表示 > サーバー エクスプローラー を選択します。

2. [データ接続] を右クリックして、[接続の追加] を選択します。[接続の追加] ダイアログで、以下の手順を実行します。

   1. [データ・ソース] で [InterSystems IRIS Data Source (.Net Framework Data Provider for InterSystems IRIS)] を選択します。

   2. [サーバー] を選択します。

   3. [ユーザー名] および [パスワード] を入力します。[接続] をクリックします。

   4. リストからネームスペースを選択します。[OK] をクリックします。

NuGet ローカル・リポジトリの構成

パッケージ・マネージャを構成し、ローカルの NuGet リポジトリを見つけ出すには、以下の手順を実行します。

1. まだディレクトリを NuGet リポジトリとして作成していない場合は、これを作成します。任意の名前と場所を使用できます。例えば、Visual Studio の既定のプロジェクト・ディレクトリにディレクトリ NuGet Repository を作成できます (<yourdoclibraryVS201x>\Projects)。

2. IrisEF サブディレクトリ IrisEF\Nuget\ から InterSystems.Data.Entity6.4.5.0.0.nupkg ファイルを NuGet リポジトリ・ディレクトリにコピーします。[OK] をクリックします。

3. Visual Studio で、プロジェクト > NuGet パッケージの管理 > 設定 > パッケージ マネージャー > パッケージ ソース を選択します。

4. プラス記号 (+) をクリックします。InterSystems.Data.Entity6.4.5.0.0.nupkg を含むパスを入力します。[OK] をクリックします。