IOrganizationService インターフェイス

注意

エンティティとテーブルの違いがわかりませんか？ Microsoft Dataverse で「開発者: 用語を理解する」を参照してください。

IOrganizationService インターフェイスは、システム テーブルとカスタム テーブル、および組織のテーブル定義で最も一般的な操作を実行するために使用される一連のメソッドを提供します。

クライアント アプリケーション

このインターフェイスは、クライアント アプリケーション作成時のコードで使用可能な幾つかのクラスに実装されています。

クラス	説明
OrganizationServiceProxy	これは WCF および SOAP エンドポイントで使用する元の下位クラスです
OrganizationWebProxyClient	この下位クラスは SOAP エンドポイントの OAuth 認証を有効にするために作成されました
CrmServiceClient	.NET クライアント アプリケーションを作成するときには、このクラスを使用する必要があります。

注意

下位レベルの OrganizationServiceProxy または OrganizationWebProxyClient クラスを使用している古いコードまたはサンプルを検索することができますが、新しい .NET クライアント アプリケーションのために CrmServiceClient を使用することをお勧めします

プラグイン

プラグインを記述する場合は、IOrganizationServiceFactory.CreateOrganizationService(Nullable<Guid>) から返されたオブジェクトもあります IOrganizationService インターフェイスは上述のクラスの幾つかの型では実装されない予定です。

IOrganizationService メソッド

IOrganizationService インターフェイスが実装された各クラスには、追加プロパティおよびメソッドが含まれますが、IOrganizationService インターフェイスにあるのは 8 つのメソッドだけです。

メソッド	内容
Associate	テーブルの関連付けを使用して 2 つのテーブル行をリンクする
Create	テーブル行を作成します。
Delete	行を削除する
Disassociate	テーブルの関連付けを使用して 2 つのテーブル行の間のリンクを削除する
Execute	OrganizationRequest のインスタンス、もしくはそこからの派生クラスを渡すことで、Message として定義する操作を呼び出します。
Retrieve	テーブル行のインスタンスを取得します。
RetrieveMultiple	クエリで設定された基準に一致するテーブル行のコレクションを取得します。
Update	テーブル行の列の値を変更します。

注意

組織サービスは Execute メソッドのみを公開しています。 IOrganizationService インターフェイスのその他のメソッドは、Execute メソッドのラッパーにすぎません。 これらのその他のメソッドが作業に便利なように、用意されています。 Execute メソッドのみを使用して全ての操作を実行できます。 詳細: メッセージを組織サービスと共に使用する

関連項目

メッセージを組織サービスと共に使用する
プラグインを記述する
組織サービスを使用したエンティティ クラスの操作

注意

ドキュメントの言語設定についてお聞かせください。 簡単な調査を行います。 (この調査は英語です)

この調査には約 7 分かかります。 個人データは収集されません (プライバシー ステートメント)。