Das SDK für .NET verwenden

Das SDK für .NET bietet Zugriff auf die Geschäftsdaten, Datentabellendefinitionen (Metadaten) und Datenoperationen, die von der Dataverse-Plattform unterstützt werden.

Es gibt bestimmte Entwicklungsszenarien, in denen das Dataverse-SDK für .NET verwendet werden muss. Wenn Sie benutzerdefinierten Code schreiben, um die Funktionalität von Dataverse zu erweitern, wie z.B. bei der Erstellung von Plug-Ins und benutzerdefinierten Workflow-Aktivitäten, müssen Sie Ihren Code mit dem .NET Framework und dem Dataverse SDK erstellen.

Abrufen der SDK-Assemblys

Verwenden Sie das SDK für .NET-Assemblys für .NET Framework- oder .NET Core-basierte Anwendungen. Für die reine .NET Framework-Entwicklung sind die SDK-Assemblys im Microsoft.CrmSdk.CoreAssemblies NuGet-Paket verfügbar. Für die Entwicklung mit .NET Framework oder .NET Core sind die SDK-Assemblys in der Microsoft.PowerPlatform.Dataverse.Client NuGet-Paket verfügbar.

Nachdem Sie das NuGet-Paket zu Ihrem Visual Studio-Projekt hinzugefügt haben, können Sie auf die Namespaces und Klassen zugreifen, die es Ihrer Anwendung ermöglichen, mit den Organization and Discovery Web Services zu interagieren.

Mit dem Organisationsservice interagieren

In diesem Abschnitt behandeln wir einige Schlüsselkonzepte zur Verwendung bereitgestellter SDK-Klassen, um eine Verbindung mit den Webdiensten herzustellen und Vorgänge auszuführen.

Herstellen einer Verbindung mit dem Webdienst

Die IOrganizationService-Schnittstelle stellt eine Verbindung zum Organisationsservice bereit, wodurch Anwendungen mit Geschäftsdaten sowie Tabellen- und Spaltendefinitionen arbeiten können. Es gibt zwei Implementierungen dieser Schnittstelle in den SDKs: CrmServiceClient und ServiceClient. Für die Entwicklung neuer Anwendungen sollten Sie die ServiceClient-Klasse verwenden, die neuere Authentifizierungstechnologien (MSAL) unterstützt und über einige zusätzliche Funktionen verfügt, die in CrmServiceClient nicht verfügbar sind. Aus API-Sicht sind beide Client-Klassen jedoch größtenteils gleich. Sie werden in dieser Dokumentation Codebeispiele sehen, die eine dieser Klassen verwenden, und es ist ziemlich einfach, Code zu konvertieren, der CrmServiceClient verwendet, um ServiceClient zu verwenden.

Mehr Informationen: Apps umstellen auf Dataverse ServiceClient, IOrganizationService-Schnittstelle

Webservicevorgänge

Im Dataverse-SDK für .NET werden Webdienstvorgänge durch Senden von Nachrichten oder Nachrichtenanforderungen an den Service initiiert. Jede Nachricht hat einen Namen, der den Zweck der Nachricht angibt, und der entsprechende Anforderungsklassenname basiert auf diesem Nachrichtennamen. Um beispielsweise eine Datenzeile in einer Tabelle zu erstellen, füllen Sie eine Erstellungsanforderung mit Daten und lassen den Dienstclient diese Anforderung an den Organisationsservice senden (Ausführen). Die Operation ist „Erstellen“ und die Nachrichtenanforderung wird CreateRequest benannt. Nach dem Ausführen einer Anfrage gibt der Dienst ein Antwortklassenobjekt zurück (z. B. CreateResponse), das einen Ausführungsstatus und Ergebnisdaten enthält. Dieses Muster gilt für die anderen Vorgänge, die der Dienst unterstützt.

Sehen Sie sich die verfügbaren Nachrichtenanforderungs- und -antwortklassen in den Microsoft.Xrm.Sdk.Messages und Microsoft.Crm.Sdk.Messages Namepsaces an.

Infos zum Legacy-SOAP-Endpunkt

Der 2011 eingeführte Organisationsservice Endpunkt, bekannt als SOAP Endpunkt, ist seit einiger Zeit veraltet. Dies bedeutet, dass er weiterhin funktioniert und unterstützt wird, bis wir ihn entfernen. Wir haben auch angekündigt, dass wir die SDK für .NET-Assemblys aktualisieren werden, sodass sie weiterhin funktionieren werden, nachdem der Endpunkt entfernt wird. Das bedeutet, dass aktualisierte SDK für .NET-Assemblys verfügbar sein werden, bevor der Endpunkt entfernt wird. Entwickler müssen ihren Code irgendwann in der Zukunft aktualisieren, um diese neuen Assemblys verwenden zu können. Die wichtigste Erkenntnis ist, dass Entwickler mit SDK für .NET auf den Organisationsservice zugreifen und den Endpunkt und sein Protokoll ignorieren können. Mehr Informationen: Apps umstellen auf Dataverse ServiceClient

Da die Web-API einen anderen Endpunkt verwendet, ist sie nicht von dieser 2011 SOAP Endpunkt-Einstellung betroffen.

Nächste Schritte,

Lassen Sie uns etwas Code schreiben! Schnellstart: SDK für .NET-Beispiel (C#)

Siehe auch

Benutzerorganisationen ermitteln
Verwenden von Plug-Ins zur Erweiterung von Geschäftsprozessen
Workflowerweiterungen

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).