Schnellstart: Ausführen eines Dataverse SDK für .NET Anforderung in C#

In dieser Schnellstartanleitung wird gezeigt, wie Sie das Microsoft Dataverse SDK für .NET in einer minimalen C#-Konsolenanwendung verwenden. Stellen Sie mithilfe der ServiceClient Klasse eine Verbindung mit dem Organisationsdienst her, und führen Sie eine Webdienstanforderung aus, um den Zugriff auf die Geschäftsdaten Ihrer Umgebung zu überprüfen.

Ihre Anwendung ruft die IOrganizationService.Execute-Methode auf und übergibt eine Instanz der WhoAmIRequest Klasse. Das vom Webdienst zurückgegebene Ergebnis ist ein ausgefüllter WhoAmIResponse.UserId-Wert, bei dem es sich um den eindeutigen Bezeichner Ihres Dataverse Systembenutzerkontos handelt.

Anmerkung

Dieses Schnellstartbeispiel enthält keine Ausnahmebehandlung für Platzgründen. Diese Schnellstartanleitung ist ein Mindestcodebeispiel dafür, mit dem Sie eine Verbindung herstellen und das SDK für .NET verwenden müssen.

Sie können das vollständige Codebeispiel aus GitHub GetStarted abrufen. Weitere Informationen finden Sie in der README-Datei des Programms.

Anforderungen

  • Visual Studio (2026 oder höher)
  • Internetverbindung
  • Anmeldeinformationen für ein Dataverse-Systembenutzerkonto für die Zielumgebung
  • URL-Adresse zur Dataverse-Umgebung, mit der Sie eine Verbindung herstellen möchten
  • Grundlegendes Verständnis der Visual C#-Sprache

Lesen Sie die folgenden wichtigen Informationen zur Verwendung einer Verbindungszeichenfolge oder zur Authentifizierung mit Benutzername/Kennwort 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.

Erstellen eines .NET Konsolen-App-Projekts in Visual Studio

  1. Erstellen Sie ein neues Projekt. Verwenden Sie für dieses Projekt Visual Studio 2026.

    Screenshot der Visual Studio mit der Option zum Starten eines neuen Projekts

  2. Wählen Sie die Projektvorlage .NET Konsolen-App aus.

    Screenshot Visual Studio mit der Projektvorlage .NET Konsolen-App.

    Wählen Sie Weiteraus.

  3. Legen Sie den Namen des Projekts und den Speicherort fest.

    Screenshot der Visual Studio mit dem Dialogfeld .NET Namen und Speicherort.

    Wählen Sie Weiteraus.

  4. Wählen Sie .NET 10.0 (Langfristige Unterstützung) als Framework aus.

    Screenshot Visual Studio mit der Konfiguration der .NET Frameworks unterstützen.

    Wählen Sie "Erstellen" aus.

  5. Klicken Sie im Lösungs-Explorer mit der rechten Maustaste auf das von Ihnen erstellte Projekt und wählen Sie im Kontextmenü NuGet-Pakete verwalten... aus.

    Screenshot von Projektmappen-Explorer mit ausgewählter Option

  6. Navigieren Sie zur neuesten Version des Microsoft.PowerPlatform.Dataverse.Client NuGet-Pakets, und installieren Sie es.

    Screenshot von NuGet-Paket-Manager mit dem Microsoft. PowerPlatform.Dataverse.Client-Paket kann installiert werden.

Anmerkung

Sie werden aufgefordert, "Für Vorschauänderungen übernehmen" auszuwählen, und wählen Sie dann im Dialogfeld "Lizenzakzeptanz" die Option "Annehmen" aus.

Hinzufügen von Code für das Dataverse SDK für .NET Anforderung

  1. Doppelklicken Sie Program.csin Projektmappen-Explorer, um die Datei zu bearbeiten. Ersetzen Sie den Inhalt der Datei durch den folgenden Code.

    using Microsoft.Crm.Sdk.Messages;
using Microsoft.PowerPlatform.Dataverse.Client;
using Microsoft.Xrm.Sdk;

/// <summary>
/// Public client authentication followed by a web service request.
/// Use of username and password for authentication.
/// </summary>
/// <remarks>This sample uses a standard app registration used for
/// demonstrating SDK code samples.</remarks>
class Program
{
    // TODO Enter your Dataverse environment's URL and logon info.
    static string url = "https://myorg.crm.dynamics.com";
    static string userName = "someone@myorg.onmicrosoft.com";
    static string password = "password";

    // This service connection string uses the info provided above.
    // The standard AppId and RedirectUri are provided for sample code demonstration only.
    static string connectionString = $@"
    AuthType = OAuth;
    Url = {url};
    UserName = {userName};
    Password = {password};
    AppId = 51f81489-12ee-4a9e-aaae-a2591f45987d;
    RedirectUri = http://localhost;
    LoginPrompt=Auto;
    RequireNewInstance = True";

    static void Main()
    {
        // ServiceClient class implements IOrganizationService interface
        IOrganizationService service = new ServiceClient(connectionString);

        var response = (WhoAmIResponse)service.Execute(new WhoAmIRequest());

        Console.WriteLine($"User ID is {response.UserId}.");


        // Pause the console so it does not close.
        Console.WriteLine("Press the <Enter> key to exit.");
        Console.ReadLine();
    }
}

  2. Ändern Sie die Werte für url, userName und password wie im Codekommentar // TODO angegeben.

    Anmerkung

    Sie finden Ihre Umgebungs-URL in der Legacy-Webanwendung unter Einstellungen > Anpassung > Entwicklerressourcen oder in Power Apps Einstellungen (Zahnradsymbol) >Entwicklerressourcen.

    Während in diesem Codebeispiel die Benutzernamen- und Kennwortinformationen im Code zur Vereinfachung platziert werden, verwenden andere Codebeispiele den empfohlenen Ansatz, diese Informationen einzugeben oder in einer separaten App.config Datei appsettings.json zu speichern.

    Sie finden die unterstützten Werte für AuthType unter Verbindungszeichenkettenparameter.

Ausführen des Programms

Drücken Sie F5, um das Programm auszuführen. Die Ausgabe sollte ähnlich wie im folgenden Beispiel aussehen:

User ID is 00aa00aa-bb11-cc22-dd33-44ee44ee44ee
Press any key to exit.

Verwenden Sie die IOrganizationService-Schnittstellenmethoden

Der Dataverse.Client.ServiceClient , den dieses Programm verwendet, implementiert die IOrganizationService Interface, die die Execute-Methode enthält.

Um die IOrganizationService Schnittstelle besser zu verstehen, führen Sie die folgenden Schritte aus:

  1. Gehen Sie zum Referenzartikel für die WhoAmIRequest-Klasse.

  2. Kopieren Sie die Beispielmethode aus diesem Artikel. Normalerweise sieht es so aus:

    /// <summary>
/// Outputs the data returned from the WhoAmI message
/// </summary>
/// <param name="service">Authenticated client implementing the IOrganizationService interface</param>
static void WhoAmIExample(IOrganizationService service) {

   var response = (WhoAmIResponse)service.Execute(new WhoAmIRequest());

   Console.WriteLine($"OrganizationId:{response.OrganizationId}");
   Console.WriteLine($"BusinessUnitId:{response.BusinessUnitId}");
   Console.WriteLine($"UserId:{response.UserId}");

}

    Beachten Sie, dass eine IOrganizationService Dienstinstanz als Parameter akzeptiert wird.

  3. Fügen Sie diese WhoAmIExample Methode unter der Main Methode in Ihrem Programm ein.

  4. Ersetzen Sie die Main Methode in Ihrem Programm durch diese:

        static void Main()
 {
     //ServiceClient implements IOrganizationService interface
     IOrganizationService service = new ServiceClient(connectionString);

     WhoAmIExample(service: service);

     // Pause the console so it does not close.
     Console.WriteLine("Press the <Enter> key to exit.");
     Console.ReadLine();
 }

  5. Führen Sie das Beispiel erneut aus. Sie sollten etwas wie Folgendes sehen:

    OrganizationId:00aa00aa-bb11-cc22-dd33-44ee44ee44ee
BusinessUnitId:11bb11bb-cc22-dd33-ee44-55ff55ff55ff
UserId:22cc22cc-dd33-ee44-ff55-66aa66aa66aa
Press the <Enter> key to exit.

Nächste Schritte

Da Sie nun über ein einfaches Konsolenprogramm verfügen, das eine Verbindung zu Dataverse herstellt, können Sie dieses Projekt verwenden, um andere Methoden und Nachrichten auszuprobieren. Mit diesem Quick Start-Konsolenanwendungsprojekt können Sie Ad-hoc-Tests durchführen.

Testen Sie andere IOrganizationService-Schnittstellenmethoden

Trinkgeld

In der Dokumentation finden Sie viele Beispielmethoden wie diese WhoAmIExample , die einen IOrganizationService service Parameter akzeptieren.

Probieren Sie die Beispiele für diese IOrganizationService-Methoden aus:

Testen sie andere Meldungen

Sie können andere Nachrichten finden, die Sie aufrufen können, indem Sie die Execute-Methode in den folgenden Namespaces verwenden:

Erfahren Sie, wie Sie mit Datensätzen arbeiten

In den folgenden Artikeln wird erläutert, wie Sie mit Geschäftsdaten in Dataverse Tabellen arbeiten:

Entdecken Sie unsere Codebeispiele

Sie finden SDK für .NET-Beispielcode in unserem GitHub-Repository unter PowerApps-Samples/dataverse/orgsvc.

Verwenden Sie ServiceClient-Erweiterungen

Zusätzlich zur Implementierung der IOrganizationService-Schnittstelle bietet ServiceClient Erweiterungsmethoden über die durch IOrganizationService definierten Kernmethoden hinaus und die Möglichkeit, die Protokollierung mit ILogger zu aktivieren. Weitere Informationen zur Verwendung des ServiceClient

  • Last updated on