Visual Studio のマネージコードプロジェクトを開始する

[アーティクル]
03/03/2017

公開日: 2017年1月

対象: Dynamics 365 (online)、Dynamics 365 (on-premises)、Dynamics CRM 2016、Dynamics CRM Online

このトピックでは、Microsoft Dynamics 365 SDK を使用するコンソールアプリケーションを構築するように適切に構成された新しいプロジェクトを Microsoft Visual Studio で作成する方法を説明します。Microsoft Dynamics 365 SDK アセンブリにリンクされるアプリケーションの作成時にプロジェクトに追加する必要がある必要な参照を調査します。

前提条件

開発用コンピューターには Microsoft Visual Studio がインストールされています。

Visual Studio Express などの任意のエディションが使用されます。サポートされる Microsoft Visual Studio のバージョンの詳細については、「Visual Studio および .NET Framework」を参照してください。
開発用コンピューターにはMicrosoft Dynamics 365 SDKがインストールされています。

Microsoft Dynamics CRM SDK パッケージをダウンロードします。開発システムの任意のフォルダーにパッケージを解くため、ダウンロードされた実行可能ファイルを実行します。

プロジェクトの作成

以下の手順では、Microsoft .NET Framework 4.5.2 を使用するコンソールアプリケーションプロジェクトを C# または VB 言語で作成する方法を説明します。サポートされる .NET Framework のバージョンの詳細については、「サポートされる Microsoft Dynamics 365 の拡張機能」を参照してください。

新しいプロジェクト

Microsoft Visual Studioで、[新しいプロジェクト] を選択します。
[テンプレート] の下の左側のナビゲーションウィンドウで、[Visual C#] または [Visual Basic] を選択します。
使用できるテンプレートの一覧の上側で、.NET Framework 4.5.2 を選択します。
テンプレートの一覧で、[コンソールアプリケーション] を選択します。
フォームの下部近くのフィールドに、プロジェクトの名前と場所を入力し、[OK] を選択します。
[プロジェクト] メニューで、プロジェクトのプロパティフォームを開き、ターゲットフレームワークが .NET Framework 4.5.2 に設定されていることを確認します。

必要なすべての参照をプロジェクトに追加する

次の手順は、プロジェクトに対して、すべての必要なアセンブリ参照を追加する方法を指示します。ほとんどのマネージコードコンソールアプリケーションで web サービスメソッドを呼び出すに必要な基本的な一連の参照を考慮してください。

必要な参照をプロジェクトに追加する別の簡単な方法は、入手できる NuGet SDK パッケージを使用する方法です。Visual Studio で NuGet パッケージマネージャーを使用して、Microsoft.CrmSdk.CoreAssemblies パッケージを検索し、プロジェクトに追加します。これにより、このトピックの残りの手順をスキップできます。

必要なシステム参照を追加する

ソリューションエクスプローラーで、プロジェクトの [参照] ノードを右クリックし、[参照の追加] を選択してから、次の参照をプロジェクトに追加します。
- System.Data.Linq
- System.DirectoryServices.AccountManagement
- System.Runtime.Serialization
- System.Security
- System.ServiceModel

必要なSDKアセンブリ参照の追加

ソリューションエクスプローラーで、プロジェクトの [参照] ノードを右クリックしてから、[参照の追加]を選択します。
[参照マネージャー] ダイアログボックスで、[参照] ボタンを選択してから、Microsoft Dynamics 365 SDK を展開したフォルダーに移動します。
SDK ダウンロードの Bin フォルダーで、Microsoft.Crm.Sdk.Proxy.dll および Microsoft.Xrm.Sdk.dll アセンブリを選択してから、[追加] をクリックします。
[OK] を選択します。

作成しているプロジェクトの特性に応じて、ある時点で必要な他の Microsoft Dynamics 365 SDK アセンブリ参照があります。ただし、組織の Web サービスにアクセスするアプリケーションコードを記述する場合、必要なのは上記の参照だけです。詳細:Microsoft Dynamics 365 SDK に含まれるアセンブリ。

必要な ID 参照の追加

Windows Identity Foundation (WIF) という名前の Windows 機能をオンにします。これを行うには、[コントロールパネル] > [プログラム] > [プログラムと機能] の順に移動します。[Windows 機能をオンまたはオフにする] を選択します。次に、リストで [Windows Identity Foundation (WIF) 3.5] を選択 (チェック) します。

または、WindowsIdentityFoundation-SDK-3.5.msi という Windows Identity Foundation (WIF) バージョン 3.5 のライブラリをダウンロードおよびインストールできます。
ソリューションエクスプローラーで、プロジェクトの [参照] ノードを右クリックしてから、[参照の追加]を選択します。
検索ボックスに、「System.IdentityModel」と入力します。
検索結果の一覧の [System.IdentityModel] を選択し、[OK] をクリックします。
手順 2 ～ 4 と同様の手順で、Microsoft.IdentityModel の参照を追加します。

次の図はプロジェクトに追加された必要なすべての参照を示します。

CRM プロジェクトに対してプロジェクト参照を追加する

次のステップ

ヒント

このトピックを閉じる前に、プロジェクトテンプレートとしてプロジェクトを保存することを検討します。次に、今後の学習プロジェクトのためにそのテンプレートを再利用すると、新しいプロジェクトの設定の時間と労力を節約できます。このため、プロジェクトがMicrosoft Visual Studioでオープンしている間に、[ファイル] メニューで、テンプレートのエクスポートを選択します。テンプレートを作成するために、ウィザードの指示に従います。

Visual Studio のマネージコードプロジェクトを開始する

前提条件