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.

Für bestimmte Entwicklungsszenarien ist die Verwendung des Dataverse SDK für .NET erforderlich. Wenn Sie benutzerdefinierten Code schreiben, um die Funktionalität von Dataverse zu erweitern, z. B. wenn Sie Plug-Ins und benutzerdefinierte Workflowaktivitäten erstellen, müssen Sie Ihren Code mithilfe des .NET Framework- und Dataverse-SDK erstellen.

SDK-Assemblys abrufen

Verwenden Sie das SDK für .NET-Assemblys für .NET Framework- oder .NET Core-basierte Anwendungen. Für die ausschließliche Entwicklung für .NET Framework beziehen Sie die SDK-Assemblys aus dem NuGet-Paket Microsoft.CrmSdk.CoreAssemblies. Für die Entwicklung mit .NET Framework oder .NET Core beziehen Sie die SDK-Assemblys aus dem NuGet-Paket Microsoft.PowerPlatform.Dataverse.Client.

Nachdem Sie das NuGet-Paket zu Ihrem Visual Studio Projekt hinzugefügt haben, haben Sie Zugriff auf die Namespaces und Klassen, mit denen Ihre Anwendung mit den Organisations- und Discovery-Webdiensten interagieren kann.

Interagieren mit dem Organisationsdienst

In diesem Abschnitt werden einige wichtige Konzepte zur Verwendung der bereitgestellten SDK-Klassen behandelt, um eine Verbindung mit den Webdiensten herzustellen und Vorgänge auszuführen.

Herstellen einer Webdienstverbindung

Die IOrganizationService-Schnittstelle stellt eine Verbindung zum Organisationsservice bereit, wodurch Anwendungen mit Geschäftsdaten sowie Tabellen- und Spaltendefinitionen arbeiten können. Das SDK enthält zwei Implementierungen dieser Schnittstelle: CrmServiceClient und ServiceClient. Verwenden Sie für die Entwicklung neuer Anwendungen die Klasse ServiceClient, die neuere Authentifizierungstechnologien (MSAL) unterstützt und über einige weitere Funktionen verfügt, die in CrmServiceClient nicht verfügbar sind. Aus API-Sicht sind beide Client-Klassen jedoch größtenteils gleich. In dieser Dokumentation finden Sie Codebeispiele, die jeweils eine dieser Klassen verwenden, und es ist ziemlich einfach, Code, der ServiceClient verwendet, so umzuschreiben, dass er CrmServiceClient verwendet.

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

Webservicevorgänge

Im Dataverse SDK für .NET initiieren Sie Webdienstvorgänge, indem Sie Nachrichten oder Nachrichtenanforderungen an den Dienst senden. 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. Wenn Sie eine Anforderung ausführen, gibt der Dienst (beispielsweise CreateResponse) ein Antwortklassenobjekt zurück, 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 Klassen für Nachrichtenanforderungen und -antworten in den Microsoft.Xrm.Sdk.Messages und Microsoft.Crm.Sdk.Messages Namespaces an.

Infos zum Legacy-SOAP-Endpunkt

Microsoft hat 2011 den Endpunkt des Organisationsdiensts eingeführt, der auch als SOAP-Endpunkt bekannt ist. Dieser Endpunkt ist veraltet. Dies bedeutet, dass es weiterhin funktioniert und unterstützt wird, bis Microsoft es entfernt. Microsoft haben außerdem angekündigt, dass sie das SDK für .NET-Assemblys aktualisieren, damit sie nach dem Entfernen des Endpunkts weiterhin funktionieren. Dies bedeutet, dass aktualisierte SDK-Assemblys für .NET verfügbar sind, 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 besteht darin, dass Entwickler über das SDK für .NET auf den Organisationsdienst zugreifen und den Endpunkt und dessen Protokoll ignorieren. Weitere Informationen finden Sie unter Transition apps to Dataverse ServiceClient.

Da die Web-API einen anderen Endpunkt verwendet, ist sie von dieser Abkündigung des SOAP-Endpunkts von 2011 nicht 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