Exemple : démarrage rapide de la connexion simplifiée avec Microsoft Dataverse

Cet exemple C# .NET montre comment se connecter au service web Microsoft Dataverse à l’aide de la classe CrmServiceClient et d’une chaîne de connexion. Ensuite, l’exemple effectue des opérations de création, de mise à jour, de récupération et de suppression des opérations sur une table Dataverse. Pour plus d’informations sur CrmServiceClient, voir Utiliser les constructeurs CrmServiceClient pour se connecter à Dataverse.

Conditions requises

• Visual Studio 2019 ou version ultérieure
• Environnement de test Dataverse et identifiants de connexion utilisateur valides

Comment exécuter l’exemple

1. Cloner le référentiel Exemples PowerApps pour en avoir une copie locale.
2. Ouvrez le fichier dataverse\Xrm Tooling\QuickStartCS\C#\QuickStartCS.sln dans Visual Studio.
3. Dans Explorateur de solutions, modifiez le fichier App.config avec les informations de connexion pour votre instance Dataverse avant de commencer à exécuter l’exemple. Voir l’exemple App.config ci-dessous.
4. Appuyez sur F5 pour compiler et exécuter le programme.

Montre ce qui suit

Cet exemple authentifie l’utilisateur avec les services web Dataverse à l’aide d’une chaîne de connexion adaptée à la classe CrmServiceClient.

Après avoir obtenu une référence au service Web d’organisation, l’exemple effectue des opérations de création, de mise à jour, de récupération et de suppression sur une table account. L’exemple gère également les exceptions courantes.

En outre, cet exemple prend en charge l’authentification OAuth et un diagnostic avancé de connexion configuré dans le fichier App.config. Pour plus d’informations sur l’utilisation des diagnostics, voir Configurer le traçage pour les outils XRM.

Exemple App.config

L’exemple suivant montre un exemple app.config file. Pour l’utiliser, supprimez les caractères de commentaire « <!- - » au début de la ligne <add name=… /> et les caractères « - -> » à la fin de la ligne dans les balises XML connectionStrings. Ensuite, modifiez le nom d’utilisateur de la chaîne de connexion, les valeurs d’URL et de mot de passe comme approprié pour votre environnement de test Dataverse.

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <connectionStrings>

  <!--<add name="Connect"
  connectionString="
  AuthType=OAuth;
  Username=jsmith@contoso.onmicrosoft.com;
  Url=https://contosotest.crm.dynamics.com;
  Password=passcode;
  AppId=51f81489-12ee-4a9e-aaae-a2591f45987d;
  RedirectUri=app://58145B91-0C36-4500-8554-080854F2AC97;
  TokenCacheStorePath=d:\MyTokenCache;
  LoginPrompt=Auto"/>-->

  </connectionStrings>
</configuration>

Voir aussi

Utiliser les chaînes de connexion des outils XRM pour se connecter à Dataverse