この記事では、.NETを使用してコーディングおよびビルドされたアプリケーションを開発するためのガイダンスを提供します。
.NET Framework アプリケーション
.NET Framework を使用してアプリケーションを開発する場合は、Xrm.Tooling 名前空間のクラスを使用して、Microsoft Dataverse Web サービスを簡単に認証して接続します。
SDK アセンブリの Xrm.Tooling クラスは IOrganizationService のインターフェース メソッドを使用します。 このプログラミング スタイルは、プラグインとワークフロー アクティビティで使用されるのと同じスタイルであるため、.NET Framework アプリケーションにどこでも使用できます。 Web サービス接続には Microsoft.Xrm.Tooling.Connector.CrmServiceClient クラスを使用します。
Xrm.Tooling クラスには、次のような多くの利点があります。
- 接続情報は、接続文字列を使用して定義できます。
- OAuth とMicrosoft 365要求ベースの認証の両方をサポートします。
- マルチスレッド環境で実行されるアクションのスレッド セーフ。
- Windows クライアント アプリケーションからの一貫したサインイン エクスペリエンスを実現するために、共通のWindows Presentation Foundation (WPF) サインイン制御を提供します。
- サインインの資格情報を安全に保存し、保存された資格情報を再利用することで、初回のサインイン後の自動サインインをサポートします。
- 実行されたアクションの組み込みの診断トレースとパフォーマンス レポート。組織の要件に基づいて構成できます。
- x509 証明書認証をサポートします。
Xrm.Tooling クラスは、IOrganizationService インターフェイス メソッドを使用するよう最適化されます。
Web API を使用する場合は、 Microsoft.Xrm.Tooling.Connector.CrmServiceClient.ExecuteCrmWebRequest メソッドを使用して、OAuth を使用する限り、 Xrm.Tooling クラスによって提供されるその他のすべての利点と共に Web API を使用して要求を作成できます。
詳細: XRM ツールを使用して Windows クライアント アプリケーションをビルドする
.NET Framework のバージョン
新しいクライアント アプリケーションを作成するときは、サポートされている .NET Framework バージョンを使用します。
SDK アセンブリを使用せずに.NET Framework アプリケーションを開発する
SDK アセンブリに依存しない場合は、「SDK アセンブリに依存することなく、Microsoft Dataverseで OAuth を使用する」で説明されているパターンを使用できます。 SDK アセンブリなしで、OData Restful Web サービス (Web API および OData グローバル検索サービス) のみを使用できます。 Web API データ操作サンプル (C#) ではこのアプローチを示します。
.NET Core アプリケーション
Microsoft.CrmSdk.XrmTooling.CoreAssembly およびその他の「crmsdk」によって提供される NuGet パッケージで利用可能な SDK API は、.NET Core コード開発をサポートしていません。
.NET Core アプリケーション開発には、前述のDataverseServiceClient クラスの後にパターン化されたCrmServiceClient クラスがあります。 アプリケーションでこの新しいサービス クライアント クラスの使用を開始するには、NuGet.org から Microsoft.PowerPlatform.Dataverse.Client パッケージをダウンロードできます。 今後のドキュメント リリースで、DataverseServiceClientおよび関連クラスのドキュメントとサンプルコードが公開される予定です。
CrmServiceClientを使用する既存の .NET Framework ベースのアプリケーション コードを更新するには、DataverseServiceClient クラスをコード内のCrmServiceClientに置き換える必要があります。 プロジェクトの種類を .NET Core アプリケーションをビルドするように設定し、.NET Framework 固有の参照設定と NuGet パッケージを削除してから、Microsoft.PowerPlatform.Dataverse.Client パッケージをプロジェクトに追加します。