Schnellstart: Organisationsservicebeispiel (C#)Quick Start: Organization service sample (C#)

Hier beginnen Sie Ihre Arbeit mit den .NET-SDK-Assemblys, um mit Daten unter Verwendung von Common Data Service zu arbeiten.This is where you begin working with the .NET SDK assemblies to work with data using Common Data Service.

In diesem Schnellstart erstellen Sie eine minimale Konsolenanwendung, um unter Verwendung der Klasse CrmServiceClient eine Verbindung mit dem Organisationsservice herzustellen.In this quick start you will create a minimum console application to connect to the Organization service using the CrmServiceClient class. Sie übergeben Ihre Verbindungsdaten mithilfe einer Verbindungszeichenfolge, die dem Konstruktor übergeben wird.You will pass your connection information using a connection string passed to the constructor.

Sie werden den IOrganizationService verwenden.ExecuteYou will use the IOrganizationService.Execute Methode zum Übergeben einer Instanz an die Klasse WhoAmIRequest, und Sie zeigen die WhoAmIResponse an.UserIdmethod passing an instance of the WhoAmIRequest class, and you will display the WhoAmIResponse.UserId Wert.value.

Hinweis

Dieses Schnellstartbeispiel enthält keine Fehlerbehandlung.This quick start example does not include error handling. Dies ist ein minimales Beispiel dafür, was Sie benötigen, um eine Verbindung mit dem Organisationsservice herzustellen und ihn zu verwenden.This is a minimum example of what you need to connect to and use the Organization service.

VoraussetzungenPrerequisites

  • Visual Studio (2017 empfohlen)Visual Studio (2017 recommended)
  • InternetverbindungInternet connection
  • Gültiges Benutzerkonto für eine Common Data Service-InstanzValid user account for a Common Data Service instance
    • Ihr BenutzernameYour username
    • Ihr KennwortYour password
  • URL zur Common Data Service-Umgebung, mit der Sie eine Verbindung herstellen möchtenUrl to the Common Data Service environment you want to connect with
  • Grundlegendes Verständnis der Visual C#-SpracheBasic understanding of the Visual C# language

Visual Studio-Projekt erstellenCreate Visual Studio project

  1. Erstellen eines neuen Konsolen-App (.NET Framework)-Projekts mit .NET Framework 4.6.2Create a new Console App (.NET Framework) project using .NET Framework 4.6.2

    Starten eines Konsolen-App-Projekts

    Hinweis

    Dieser Screenshot zeigt den Namen OrgServiceQuickStart an, aber Sie können für das Projekt und die Lösung einen beliebigen Namen auswählen.This screenshot shows the name OrgServiceQuickStart, but you can choose to name the project and solution whatever you want.

  2. 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.In Solution Explorer, right-click the project you created and select Manage NuGet Packages... in the context menu.

    NuGet-Paket hinzufügen

  3. Navigieren Sie zur neuesten Version des NuGet-Pakets Microsoft.CrmSdk.XrmTooling.CoreAssembly und installieren Sie es.Browse for the latest version of the Microsoft.CrmSdk.XrmTooling.CoreAssembly NuGet package and install it.

    Installieren des NuGet-Pakets Microsoft.CrmSdk.XrmTooling.CoreAssembly

Hinweis

Sie müssen Ich stimme zu im Dialogfeld Lizenz-Abnahme auswählen.You must select I Accept in the Licence Acceptance dialog.

Bearbeiten von Program.csEdit Program.cs

  1. Fügen Sie diese Using-Anweisungen am Anfang von Program.cs hinzuAdd these using statements to the top of Program.cs

    using Microsoft.Crm.Sdk.Messages;
    using Microsoft.Xrm.Tooling.Connector;
    
  2. Ersetzen Sie die Main-Methode durch den folgenden Code.Replace the Main method with the following code. Die unterstützten Werte für AuthType sind unter Parameter für Verbindungszeichenfolgen aufgeführt.The supported values for AuthType are listed in Connection string paramters.

    static void Main(string[] args)
    {            
        // e.g. https://yourorg.crm.dynamics.com
        string url = "<your environment url>";
        // e.g. you@yourorg.onmicrosoft.com
        string userName = "<your user name>";
        // e.g. y0urp455w0rd 
        string password = "<your password>";
    
        string conn = $@"
        Url = {url};
        AuthType = Office365;
        UserName = {userName};
        Password = {password};
        RequireNewInstance = True";
    
        using (var svc = new CrmServiceClient(conn))
        {
    
            WhoAmIRequest request = new WhoAmIRequest();
    
            WhoAmIResponse response = (WhoAmIResponse)svc.Execute(request);
    
            Console.WriteLine("Your UserId is {0}", response.UserId);
    
            Console.WriteLine("Press any key to exit.");
            Console.ReadLine();
        }
    }
    
  3. Bearbeiten Sie die folgenden Werte, um Informationen für die Umgebung hinzuzufügen.Edit the following values to add information for your environment. Ihre Umgebungs-URL finden Sie in der Webanwendung unter Einstellungen > Anpassung > Entwicklerressourcen.You can find your environment URL in the Web application under Settings > Customization > Developer Resources.

    // e.g. https://yourorg.crm.dynamics.com
    string url = "<your environment url>";
    // e.g. you@yourorg.onmicrosoft.com
    string userName = "<your user name>";
    // e.g. y0urp455w0rd
    string password = "<your password>";
    

Ausführen des ProgrammsRun the program

  1. Drücken Sie F5, um das Programm auszuführen.Press F5 to run the program. Die Ausgabe sollte wie folgt aussehen:The output should look like this:

    Your UserId is 969effb0-98ae-478c-b547-53a2968c2e75
    Press any key to exit.
    

Herzlichen Glückwunsch!Congratulations!

Sie haben erfolgreich eine Verbindung mit dem Organisationsservice hergestellt.You have successfully connected to the organization service.

Nächste SchritteNext Steps

Diese Themen erklären mehr über das Arbeiten mit Common Data Service-Entitäten:These topics will explain how to work with Common Data Service entities:

Entitäts-Vorgänge mithilfe des OrganisationsserviceEntity Operations using the Organization service
Erstellen von Entitäten mit dem OrganisationsserviceCreate entities using the Organization Service
Abrufen einer Entität mithilfe des OrganisationsdienstesRetrieve an entity using the Organization Service
Aktualisieren und Löschen von Entitäten mit dem OrganisationsserviceUpdate and Delete entities using the Organization Service
Entitäten mithilfe des Organisations-Service zuordnen oder trennenAssociate and disassociate entities using the Organization Service