このトピックでは、.NETを使用してコーディングおよびビルドされたアプリケーションを開発する場合のガイダンスを提供します。
.NET Framework アプリケーション
アプリケーションの開発時に .NET Framework を使用している場合は、Xrm.Tooling 名前空間内のクラスを使用して、Microsoft Dataverse Web サービスを簡単に認証して接続できます。
SDK アセンブリの Xrm.Tooling クラスは IOrganizationService のインターフェース メソッドを使用します。 これは、プラグインやワークフロー アクティビティで使用されるプログラミングと同じスタイルであり、.NET Framework アプリケーションにどこでも使用できる 1 つのスタイルになります。
Microsoft.Xrm.Tooling.Connector.CrmServiceClient クラスを Web サービスへの接続用に使用することをお勧めします。
Xrm.Tooling クラスが提供する利点には次のものが含まれます。
- connection stringを使用して接続情報を定義できます。
- OAuth とMicrosoft 365要求ベースの認証の両方をサポートします。
- マルチスレッド環境で実行されるアクションのスレッドの安全性。
- Windows クライアント アプリケーションからの一貫したサインイン エクスペリエンスのための共通のWindows Presentation Foundation (WPF) ログイン 制御を提供します。
- サインインの資格情報を安全に保存し、保存された資格情報を再利用することで、初回のサインイン後の自動サインインをサポートします。
- 実行されたアクションの組み込みの診断トレースとパフォーマンス レポート。組織の要件に基づいて構成できます。
- x509 証明書認証をサポートします。
Xrm.Tooling クラスは、IOrganizationService インターフェイス メソッドを使用するよう最適化されます。
Web API を使用する場合、Microsoft.Xrm.Tooling.Connector.CrmServiceClient.ExecuteCrmWebRequest メソッドを使用することで、Xrm.Tooling クラスで提供される他のすべての利点と、OAuth を使用する限り、Web API を使用してリクエストを構成することができます。
詳細: XRM ツールを使用したクライアント アプリケーションWindowsビルド
.NET Framework のバージョン
クライアント アプリケーションを作成するときは、.NET Framework バージョン 4.6.2 以降を使用します。 Transport Level Security (TLS) 1.2 またはそれより優れたセキュリティを使用するアプリケーションのみが接続できます。 TLS 1.2 は、.NET Framework 4.5.2 で使用される既定のプロトコルではありませんが、.NET Framework 4.6.2 以降にあります。
SDK アセンブリを使用せずに.NET Framework アプリケーションを開発する
SDK アセンブリに依存関係を持たないようにする場合は、「
.NET Core および .NET 6 アプリケーション
Microsoft.CrmSdk.XrmTooling.CoreAssembly およびその他の "crmsdk" 所有の NuGet パッケージで使用できる SDK API は、コア コード開発.NETサポートしていません。
.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 パッケージをプロジェクトに追加する必要があります。