Freigeben über


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

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.

Anmerkung

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 dies zu verwenden, entfernen Sie die Kommentarzeichen “<!- -” am Anfang der Zeile <add name=… /> und das „-->“ am Ende der Zeile innerhalb der connectionStrings-XML-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>

Lesen Sie die folgenden wichtigen Informationen zur Verwendung einer Verbindungszeichenfolge im Anwendungscode.

Wichtig

Microsoft empfiehlt, den sichersten verfügbaren Authentifizierungsflow zu verwenden. Der in diesem Artikel beschriebene Authentifizierungsablauf erfordert ein sehr hohes Maß an Vertrauen in die Anwendung und birgt Risiken, die in anderen Flows nicht vorhanden sind. Sie sollten diesen Flow nur verwenden, wenn andere, sicherere Flows, z. B. verwaltete Identitäten, nicht funktionsfähig sind.

Siehe auch

Verwenden von Verbindungszeichenfolgen im XRM-Tooling zur Herstellung einer Verbindung mit Dataverse