Démarrage rapide : Exécuter un Kit de développement logiciel (SDK) Dataverse pour .NET demande en C#

Ce guide de démarrage rapide montre comment utiliser le Kit de développement logiciel (SDK) Microsoft Dataverse pour .NET dans une application console C# minimale. Connectez-vous au service Organisation à l’aide de la ServiceClient classe et exécutez une demande de service web pour vérifier l’accès aux données métier de votre environnement.

Votre application appelle la méthode IOrganizationService.Execute et transmet une instance de la WhoAmIRequest classe. Le résultat renvoyé par le service web est une valeur WhoAmIResponse.UserId renseignée qui est l’identificateur unique de votre compte d’utilisateur système Dataverse.

Nonte

Cet exemple de démarrage rapide n’inclut pas la gestion des exceptions pour la concision. Ce guide de démarrage rapide est un exemple de code minimal de ce à quoi vous devez vous connecter et utiliser le Kit de développement logiciel (SDK) pour .NET.

Vous pouvez obtenir l’exemple de code complet de GitHub GetStarted. Consultez le README du programme pour plus de détails.

Conditions préalables

Visual Studio (2026 ou version ultérieure)
Connexion Internet
Informations d’identification de connexion pour un compte d’utilisateur système Dataverse pour l’environnement cible
Adresse URL vers l’environnement Dataverse auquel vous voulez vous connecter
Présentation de base du langage Visual C #

Lisez les informations importantes suivantes sur l’utilisation d’une chaîne de connexion ou de l’authentification par nom d’utilisateur/mot de passe dans le code d’application.

Important

Microsoft vous recommande d’utiliser le flux d’authentification le plus sécurisé disponible. Le flux d’authentification décrit dans cet article nécessite un très haut degré de confiance dans l’application et comporte des risques qui ne sont pas présents dans d’autres flux. Vous ne devez utiliser ce flux que lorsque d’autres flux plus sécurisés, tels que les identités managées, ne sont pas viables.

Créer un projet d’application console .NET dans Visual Studio

Créez un nouveau projet. Pour ce projet, utilisez Visual Studio 2026.
Choisissez le modèle de projet d’application console .NET.

Sélectionnez Suivant.
Définissez le nom du projet et l’emplacement.

Sélectionnez Suivant.
Sélectionnez .NET 10.0 (support à long terme) comme framework.

Cliquez sur Créer.
Dans l’Explorateur de solutions, cliquez avec le bouton droit sur le projet que vous avez créé, puis sélectionnez Gérer les packages NuGet… dans le menu contextuel.
Recherchez la dernière version du package Microsoft.PowerPlatform.Dataverse.Client NuGet et installez-la.

Nonte

Vous êtes invité à sélectionner Appliquer aux modifications d’aperçu, puis à sélectionner J’accepte dans la boîte de dialogue Acceptation de licence .

Ajouter du code pour le Kit de développement logiciel (SDK) Dataverse pour .NET demande

Dans Explorateur de solutions, double-cliquez Program.cs pour modifier le fichier. Remplacez le contenu du fichier par le code suivant.

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();
    }
}

Modifiez les valeurs du url, userName, et password comme l’indique le // TODO commentaire de code.

Nonte

L’URL de votre environnement se trouve dans l’application web héritée sous Paramètres > Personnalisation > Ressources du développeur ou dans Power Apps sous Paramètres (icône d’engrenage) >Ressources du développeur.

Bien que cet exemple de code place les informations de nom d’utilisateur et de mot de passe dans le code par souci de simplicité, d’autres exemples de code utilisent l’approche plus recommandée pour demander ces informations ou les stocker dans un fichier ou appsettings.json un fichier distinctApp.config.

Les valeurs prises en charge pour AuthType sont répertoriées dans Paramètres de la chaîne de connexion.

Exécuter le programme

Appuyez sur la touche F5 pour exécuter le programme. La sortie doit être semblable à l’exemple suivant :

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

Utilisez les méthodes de l’interface IOrganizationService

Dataverse.Client.ServiceClient que ce programme utilise implémente l’interface IOrganizationService, qui inclut la méthode Execute.

Pour mieux comprendre l’interface IOrganizationService , procédez comme suit :

Accédez à l’article de référence sur la classe WhoAmIRequest.

Copiez l’exemple de méthode de cet article. Il ressemble à ça :

/// <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}");

}

Notez qu’il accepte une IOrganizationService instance de service comme paramètre.

Collez cette WhoAmIExample méthode sous la Main méthode de votre programme.

Remplacez la Main méthode de votre programme par ceci :

    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();
 }

Réexécutez l’exemple. Vous devriez voir quelque chose comme ceci :

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

Étapes suivantes

Maintenant que vous disposez d’un programme console simple qui se connecte à Dataverse, utilisez ce projet pour essayer d’autres méthodes et messages. Vous pouvez utiliser ce projet d’application de console Quick Start pour effectuer des tests ad hoc.

Essayez un autre méthodes de l’interface IOrganizationService

Astuce

Dans la documentation, vous trouverez de nombreux exemples de méthodes comme celle-ci WhoAmIExample qui acceptent un IOrganizationService service paramètre.

Essayez les exemples de ces méthodes IOrganizationService :

Essayer autres messages

Vous trouverez d’autres messages que vous pouvez appeler à l’aide de la méthode Execute dans ces espaces de noms :

Découvrir comment travailler avec des données d’enregistrement

Les articles suivants expliquent comment utiliser les données d’entreprise dans Dataverse tableaux :

Découvrez nos exemples de code

Vous pouvez trouver un exemple de code SDK pour .NET dans notre référentiel GitHub à l’adresse PowerApps-Samples/dataverse/orgsvc.

Utiliser les extensions ServiceClient

En plus d’implémenter l’ interface IOrganizationService, ServiceClient offre des méthodes d’extension au-delà des méthodes de base définies par IOrganizationService et la possibilité d’activer la journalisation avec ILogger. En savoir plus sur ServiceClient

Commentaires

Cette page a-t-elle été utile ?

Last updated on 2026-08-13