クイックスタート: C で dataverse SDK for .NET 要求を実行する#

このクイックスタートでは、最小限の C# コンソールアプリケーションで Microsoft Dataverse SDK for .NETを使用する方法について説明します。 ServiceClient クラスを使用して Organization サービスに接続し、Web サービス要求を実行して、環境のビジネスデータへのアクセスを確認します。

アプリケーションは IOrganizationService.Execute メソッドを呼び出し、 WhoAmIRequest クラスのインスタンスを渡します。 Web サービスから返される結果は、Dataverse システムユーザーアカウントの一意の識別子である WhoAmIResponse.UserId の値です。

注意

このクイックスタートの例には、簡潔な例外処理は含まれていません。このクイックスタートは、SDK for .NETに接続して使用するために必要な最小限のコード例です。

GetStarted から完全なコードサンプルGitHub取得できます。詳細については、プログラムの README を参照してください。

前提条件

Visual Studio (2026 以降)
インターネット接続
ターゲット環境の Dataverse システムユーザーアカウントのサインイン資格情報
接続先の Dataverse 環境の URL アドレス
Visual C# 言語の基本的な理解

アプリケーションコードでの接続文字列またはユーザー名/パスワード認証の使用については、次の重要な情報をお読みください。

重要

Microsoft では、利用可能な最も安全な認証フローを使用することをお勧めします。この記事で説明する認証フローは、アプリケーションに対する非常に高い信頼を必要とし、他のフローには存在しないリスクを伴います。このフローは、マネージド ID など、他のより安全なフローが実行できない場合にのみ使用してください。

Visual Studioで.NET コンソールアプリプロジェクトを作成する

新しいプロジェクトを作成します。このプロジェクトでは、Visual Studio 2026 を使用します。
.NETコンソールアプリプロジェクトテンプレートを選択します。

次へを選択します。
プロジェクトの名前と場所を設定します。

次へを選択します。
フレームワークとして .NET 10.0 (長期サポート) を選択します。

を選択してを作成します。
ソリューションエクスプローラー で、作成したプロジェクトを右クリックして、コンテキストメニューで NuGet パッケージの管理... を選択します。
NuGet パッケージの最新バージョンをMicrosoft.PowerPlatform.Dataverse.Clientして、インストールします。

注意

[変更のプレビューに適用] を選択し、[ライセンスの同意] ダイアログで [同意する] を選択するように求められます。

.NET要求用の Dataverse SDK のコードを追加する

ソリューションエクスプローラーで、Program.csをダブルクリックしてファイルを編集します。ファイルの内容を次のコードに置き換えます。

using Microsoft.Crm.Sdk.Messages;
using Microsoft.PowerPlatform.Dataverse.Client;
using Microsoft.Xrm.Sdk;

/// <summary>
/// Public client authentication followed by a web service request.
/// Use of username and password for authentication.
/// </summary>
/// <remarks>This sample uses a standard app registration used for
/// demonstrating SDK code samples.</remarks>
class Program
{
    // TODO Enter your Dataverse environment's URL and logon info.
    static string url = "https://myorg.crm.dynamics.com";
    static string userName = "someone@myorg.onmicrosoft.com";
    static string password = "password";

    // This service connection string uses the info provided above.
    // The standard AppId and RedirectUri are provided for sample code demonstration only.
    static string connectionString = $@"
    AuthType = OAuth;
    Url = {url};
    UserName = {userName};
    Password = {password};
    AppId = 51f81489-12ee-4a9e-aaae-a2591f45987d;
    RedirectUri = http://localhost;
    LoginPrompt=Auto;
    RequireNewInstance = True";

    static void Main()
    {
        // ServiceClient class implements IOrganizationService interface
        IOrganizationService service = new ServiceClient(connectionString);

        var response = (WhoAmIResponse)service.Execute(new WhoAmIRequest());

        Console.WriteLine($"User ID is {response.UserId}.");


        // Pause the console so it does not close.
        Console.WriteLine("Press the <Enter> key to exit.");
        Console.ReadLine();
    }
}

url コードのコメントに示されているように、userName、password、// TODO の値を変更します。

注意

環境 URLは、レガシ Web アプリケーションの 設定 > カスタマイズ > 開発者リソースまたは Power Apps の設定 (歯車のアイコン) >開発者リソース にあります。

このコードサンプルでは、わかりやすくするためにユーザー名とパスワードの情報をコードに配置しますが、他のコードサンプルでは、その情報の入力を求める、または別の App.config または appsettings.json ファイルに格納する、より推奨される方法を使用します。

AuthType でサポートされる値の一覧は、接続文字列のパラメーターにあります。

プログラムを実行する

F5 キーを押してプログラムを実行します。出力は次の例のようになるはずです。

User ID is 00aa00aa-bb11-cc22-dd33-44ee44ee44ee
Press any key to exit.

IOrganizationService インターフェイスメソッドを使用する

このプログラムで使用される Dataverse.Client.ServiceClient は、Execute メソッドを含む IOrganizationService インターフェイスを実装します。

IOrganizationService インターフェイスについて理解を深めるために、次の手順を試してください。

WhoAmIRequest クラスの参考記事に移動します。

その記事からサンプルメソッドをコピーします。次のようになります。

/// <summary>
/// Outputs the data returned from the WhoAmI message
/// </summary>
/// <param name="service">Authenticated client implementing the IOrganizationService interface</param>
static void WhoAmIExample(IOrganizationService service) {

   var response = (WhoAmIResponse)service.Execute(new WhoAmIRequest());

   Console.WriteLine($"OrganizationId:{response.OrganizationId}");
   Console.WriteLine($"BusinessUnitId:{response.BusinessUnitId}");
   Console.WriteLine($"UserId:{response.UserId}");

}

注意: これは IOrganizationService サービスインスタンスをパラメーターとして受け入れます。

この WhoAmIExample メソッドをプログラムの Main メソッドの下に貼り付けます。

このプログラムの Main メソッドを、以下と置き換えます。

    static void Main()
 {
     //ServiceClient implements IOrganizationService interface
     IOrganizationService service = new ServiceClient(connectionString);

     WhoAmIExample(service: service);

     // Pause the console so it does not close.
     Console.WriteLine("Press the <Enter> key to exit.");
     Console.ReadLine();
 }

サンプルをもう一度実行します。次のような結果が表示されます。

OrganizationId:00aa00aa-bb11-cc22-dd33-44ee44ee44ee
BusinessUnitId:11bb11bb-cc22-dd33-ee44-55ff55ff55ff
UserId:22cc22cc-dd33-ee44-ff55-66aa66aa66aa
Press the <Enter> key to exit.

次のステップ

これで、Dataverse に接続する単純なコンソールプログラムが完成しました。このプロジェクトを使用して、他のメソッドやメッセージをお試しください。このクイックスタートコンソールアプリケーションプロジェクトを使用して、アドホックテストを実施できます。

他の IOrganizationService インターフェイスメソッドを試す

チップ

このドキュメントでは、IOrganizationService service パラメーターを受け取るこのWhoAmIExampleのような多くのメソッド例を見つけることができます。

次の IOrganizationService メソッドの例を試してください。

その他のメッセージを試す

これらの名前空間で Execute メソッドを使用して呼び出すことができる他のメッセージを見つけることができます。

レコードデータの操作方法について説明します

Dataverse テーブルが含むビジネスデータの操作方法について、次の記事で説明します。

サンプルコードを探索する

.NET 用 SDK のサンプルコードは、Microsoft の GitHub リポジトリ PowerApps-Samples/dataverse/orgsvc に用意されています。

ServiceClient 拡張機能を使用する

IOrganizationService インターフェイスの実装に加えて、ServiceClient は、IOrganizationService によって定義されたコアメソッドを超える拡張メソッドと、ILogger によるログを有効化する機能を提供します。 ServiceClient の使用に関する詳細情報

フィードバック

このページはお役に立ちましたか?

Last updated on 2026-08-13

クイック スタート: C で dataverse SDK for .NET 要求を実行する#

前提条件

Visual Studioで.NET コンソール アプリ プロジェクトを作成する