Beispiel: Schnellstart für XRM Tooling API
Dieses C# .NET-Codebeispiel zeigt, wie Sie mithilfe des WPF-basierten login-Steuerelements der XRM-Tools eine Verbindung zu einer Microsoft Dataverse-Umgebung herstellen. Als Nächstes führt das Beispiel Erstellungs-, Aktualisierungs-, Abruf- und Löschvorgänge für eine Dataverse-Tabelle aus. Weitere Informationen zur XRM-Tooling finden Sie unter Erstellen von Windows-Client-Anwendungen mithilfe der XRM-Tools.
Anforderungen
- Visual Studio 2019 oder höher
- Dataverse Testumgebung und gültige Benutzeranmeldeinformationen
Wie das Beispiel ausgeführt wird
- Klonen Sie das Repository PowerApps-Beispiele, sodass Sie eine lokale Kopie haben.
- Öffnen Sie die Datei
dataverse\Xrm Tooling\Quick start for XRM Tooling\C#\QuickStartXRMToolingWPFClient.sln
in Visual Studio. - Drücken Sie F5, um das Programm zu kompilieren und auszuführen.
Sie werden zur Eingabe von Anmeldeinformationen für die Umgebung aufgefordert.
Veranschaulichung
- Der Beispielcode stellt ein allgemeines login-Steuerelement mit integrierter Unterstützung für Zwischenspeicherung und Wiederverwendung von Authentifizierungs- und Anmeldeinformationen bereit. Weitere Informationen zum allgemeinen login-Steuerelement finden Sie in Das allgemeine login-Steuerelement der XRM-Tools verwenden.
- Nach der Verbindung mit Dataverse führt das Beispiel Erstellungs-, Aktualisierungs-, Abruf- und Löschvorgänge an einer Kontotabelle aus.
- Speichert Benutzeranmeldeinformationen in einer Konfigurationsdatei (
Default_QuickStartXRMToolingWPFClient.exe.config
) im Ordnerc:\Users\
<username>
\AppData\Roaming\Microsoft\QuickStartXRMToolingWPFClient
, wenn das Beispiel zum ersten Mal ausgeführt wird, und fordert danach den Benutzer auf, entweder die gespeicherten Anmeldeinformationen zu verwenden oder in der Laufzeit neue anzugeben, um sich bei Dataverse anzumelden. - Generiert, wenn Probleme auftreten, die folgenden Protokolldateien, um die Problembehandlung zu unterstützen:
- Login_ErrorLog.log: Um Anmeldungsfehler zu melden. Diese Datei ist unter
C:\Users\
<username>
\AppData\Roaming\Microsoft\QuickStartXRMToolingWPFClient
verfügbar. - QuickStartXRMToolingWPFClient.log: Um Betriebsfehler zu melden. Diese Datei ist am gleichen Ort verfügbar wie die ausführbare Datei, d. h. im Ordner "Debuggen" Ihres Visual Studio-Projekts.
- Login_ErrorLog.log: Um Anmeldungsfehler zu melden. Diese Datei ist unter
Siehe auch
Verwenden Sie das allgemeine XRM Toolinng-Anmeldungssteuerelement
Erstellen von Windows-Client-Anwendungen mithilfe der XRM-Tools
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).