Freigeben über

Starten eines verwalteten Codeprojekts in Visual Studio

  • Artikel

 

Veröffentlicht: November 2016

Gilt für: Dynamics CRM 2015

In diesem Thema wird gezeigt, wie Sie in Microsoft Visual Studio ein neues Projekt erstellen, das korrekten konfiguriert ist, um eine Konsolenanwendung zu unterstützen, die Microsoft Dynamics CRM SDK verwendet.

Erforderliche Komponenten

  • Microsoft Visual Studio, das auf dem Entwicklungscomputer installiert ist.

    Sämtliche Versionen, einschließlich Visual Studio Express, sollten funktionieren. Weitere Information zu den unterstützten Versionen von Microsoft Visual Studio finden Sie unter Visual Studio und .NET Framework.

  • Microsoft Dynamics CRM SDK, das auf dem Entwicklungscomputer installiert ist.

    Laden Sie das Microsoft Dynamics CRM SDK-Paket herunter. Führen Sie die heruntergeladene ausführbare Datei aus, um das Paket in jedem Ordner auf dem Entwicklungssystem zu entpacken.

    Wichtig

    Für die 7.1.0 Vorschauversion sind die SDK-Assemblys nur in NuGet-Paketen verfügbar. Ein vollständiger SDK-Download, der die Assemblys enthält, wird in der 7.1.0 RTM-Version zur Verfügung gestellt.

Erstellen eines Projekts

Im folgenden Verfahren wird veranschaulicht, wie ein Konsolenanwendungsprojekt in der Sprache C# oder VB erstellt wird, die Microsoft .NET Framework 4.5.2 verwendet. Weitere Information zu den unterstützten Versionen von .NET Framework finden Sie unter Unterstützte Erweiterungen für Microsoft Dynamics CRM 2015.

Neues Projekt

  1. Wählen Sie in Microsoft Visual Studio die Option Neues Projekt aus.

  2. Wählen Sie im linken Navigationsbereich unter Vorlagen die Option Visual C# oder Visual Basic aus.

  3. Wählen Sie über der Liste der verfügbaren Vorlagen die Option .NET Framework 4.5.2 aus.

  4. Wählen Sie in der Vorlagenliste die Option Konsolenanwendung aus.

    Ein neues Konsolen-App-Projektdialogfeld in Dynamics 365

  5. Geben Sie für das Projekt in den Feldern in der Nähe des unteren Bereich des Formulars einen Speicherort und einen Namen an, und wählen Sie dann OK aus.

  6. Öffnen Sie im Menü Projekt das Eigenschaftenformular des Projekts und überprüfen Sie, ob das Zielframework auf .NET Framework 4.5.2 festgelegt ist. Verwenden Sie nicht das .NET Framework 4.5.2-Client-Profil.

    Auswählen des Zielframeworks für das CRM-Projekt

Fügen Sie dem Projekt alle benötigten Verweise hinzu

Die folgenden Schritte zeigen Ihnen, wie dem Projekt alle erforderlichen Assembly-Verweise hinzugefügt werden. Betrachten Sie das als einen Basisverweissatz, der von den meisten Code-Anwendungen mit verwaltetem Code zum Aufrufen von Webdienstmethoden benötigt wird.

Eine alternative und einfache Möglichkeit, die erforderlichen Verweise Ihrem Projekt hinzuzufügen, ist es, das verfügbare NuGet-SDK-Paket zu verwenden. Unter Verwendung des NuGet Paketmanagers in Visual Studio, suchen Sie das Microsoft.CrmSdk.CoreAssemblies-Paket und fügen Sie es dem Projekt hinzu. Sie können dann die verbleibenden Anweisungen in diesem Thema überspringen

Wenn Sie jedoch eine Anwendung schreiben, die auf den OData-Webdienst-Endpunkt zugreift, müssen Sie dem Projekt keine SDK-Assemblyverweise hinzufügen. Weitere Informationen zum Schreiben von Apps, die auf den OData-Endpunkt zugreifen, finden Sie unter Schreiben von mobilen und modernen Apps.

Hinzufügen der erforderlichen Systemreferenzen

  1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Verweise-Knoten des Projekts, wählen Sie Verweise hinzufügen aus, und fügen Sie dem Projekt dann die folgenden Verweise hinzu.

    • System.Data.Linq

    • System.DirectoryServices.AccountManagement

    • System.Runtime.Serialization

    • System.Security

    • System.ServiceModel

Hinzufügen der erforderlichen Verweise für die SDK-Assembly

  1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Knoten Verweise des Projekts, und wählen Sie dann Verweise hinzufügen aus.

  2. Wählen Sie im Dialogfeld Verweise-Manager die Schaltfläche Durchsuchen aus, und navigieren Sie dann zu dem Ordner, in dem Sie Microsoft Dynamics CRM SDK extrahiert haben.

  3. Im Ordner "Bin" des SDK-Downloads, wählen Sie die Assemblys "Microsoft.Crm.Sdk.Proxy.dll" und "Microsoft.Xrm.Sdk.dll" aus. Klicken Sie dann auf Hinzufügen.

  4. Wählen Sie OK aus.

Es gibt weitere Microsoft Dynamics CRM SDK-Assemblyverweise, die unter Umständen, abhängig von der Art des Projekts das Sie erstellen, irgendwann benötigen. Für das Verfassen von Anwendungscode, der auf den Organisationswebdienst zugreift, reichen die oben genannten Verweise aus.Weitere Informationen:Im Microsoft Dynamics CRM 2015-SDK enthaltene Assemblies.

Hinzufügen der erforderlichen Identitätsreferenzen

  1. Downloaden und installieren Sie die Windows Identity Framework (WIF) Version 3.5_bibliothek namens WindowsIdentityFoundation-SDK-3.5.msi.

  2. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Knoten Verweise des Projekts, und wählen Sie dann Verweise hinzufügen aus.

  3. Geben Sie im Feld Suche System.IdentityModel ein.

  4. Wählen Sie in der Suchergebnisliste System.IdentityModel.dll aus, und klicken Sie auf OK.

  5. Wie in den Schritten 2 bis 4, fügen Sie einen Verweis für Microsoft.IdentityModel hinzu.

Im folgenden Diagramm werden alle erforderlichen Verweise dargestellt, die einem Projekt hinzugefügt werden.

Hinzufügen der Projektverweise für das CRM-Projekt

Nächste Schritte

Tipp

Bevor Sie das Thema verlassen, sollten Sie darüber nachdenken, das Projekt als Projektvorlage zu speichern. Sie können die Vorlage dann wieder für zukünftige Lernprojekte verwenden und sich etwas Zeit und Aufwand bei der Erstellung neue Projekte ersparen. Wählen Sie dazu im Menü Datei die Option Exportvorlage, aus, während das Projekt in Microsoft Visual Studio geöffnet ist. Befolgen Sie Assistentenanweisungen zum Erstellen der Vorlage.

Siehe auch

Erste Schritte bei der verwalteten Codeanwendungsentwicklung

© 2017 Microsoft. Alle Rechte vorbehalten. Copyright