Beispiel: Erste Schritte für einfacheres Herstellen von Verbindungen mithilfe von Microsoft Dataverse

  • Artikel

Dieses C# .NET-Beispiel zeigt, wie Sie mithilfe der CrmServiceClient-Klasse und einer Verbindungszeichenfolge eine Verbindung zum Microsoft Dataverse-Webdienst herstellen. Das Beispiel führt dann Erstellungs-, Aktualisierungs-, Abruf- und Löschvorgänge für eine Dataverse-Tabelle aus. Weitere Informationen zu CrmServiceClient finden Sie unter Verwenden von CrmServiceClient-Konstruktoren, um eine Verbindung mit Dataverse herzustellen.

Hinweis

Sie können in diesem Beispiel den ServiceClient statt der CrmServiceClient-Klasse verwenden.

Anforderungen

  • Visual Studio 2019 oder höher
  • Dataverse Testumgebung und gültige Benutzeranmeldeinformationen

Wie das Beispiel ausgeführt wird

  1. Klonen Sie das Repository PowerApps-Beispiele, sodass Sie eine lokale Kopie haben.
  2. Öffnen Sie die Datei dataverse\Xrm Tooling\QuickStartCS\C#\QuickStartCS.sln in Visual Studio.
  3. Sie müssen im Projektmappen-Explorer die App.config-Datei mit den Verbindungsinformationen für die Dataverse-Instanz ändern, bevor Sie das Beispiel ausführen. Siehe die Beispiel-App.config unten.
  4. Drücken Sie F5, um das Programm zu kompilieren und auszuführen.

Veranschaulichung

Dieses Beispiel authentifiziert den Benutzer bei den Dataverse-Webdiensten mithilfe einer Verbindungszeichenfolge, die an die CrmServiceClient-Klasse übergeben wird.

Nachdem ein Verweis auf den Organisationswebdienst abgerufen wurde, führt das Beispiel Erstellungs-, Aktualisierungs-, Abruf- und Löschvorgänge für eine account-Tabelle aus. Das Beispiel behandelt zudem allgemeine Ausnahmen.

Außerdem unterstützt dieses Beispiel OAuth-Authentifizierung und die erweiterte Verbindungsdiagnose, die in der App.config-Datei konfiguriert ist. Weitere Informationen zur Verwendung der Diagnose, siehe Konfigurieren der Nachverfolgung für XRM Tooling.

Beispiel-App.config

Das folgende Beispiel zeigt app.config file Um es zu verwenden, entfernen Sie die Kommentarzeichen „<!- -“ am Anfang der <add name=… />-Zeile und „- ->“ am Ende der Zeile in den connectionStrings-CML-Tags. Ändern Sie als Nächstes die Werte für den Benutzernamen, die URL und das Kennwort der Verbindungszeichenfolge entsprechend den Anforderungen Ihrer Dataverse-Test Umgebung.

<?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>

Siehe auch

Verwenden von Verbindungszeichenfolgen im XRM-Tooling zum Herstellen einer Verbindung zu Dataverse

Hinweis

Können Sie uns Ihre Präferenzen für die Dokumentationssprache mitteilen? Nehmen Sie an einer kurzen Umfrage teil. (Beachten Sie, dass diese Umfrage auf Englisch ist.)

Die Umfrage dauert etwa sieben Minuten. Es werden keine personenbezogenen Daten erhoben. (Datenschutzbestimmungen).