Aufrufen von Office 365-Diensten in Visual Studio 2017 mit der Microsoft Graph-APICall Office 365 services in Visual Studio 2017 with the Microsoft Graph API

Sie können Connected Services in Visual Studio verwenden, um Ihre App für den Aufruf der Microsoft Graph-API zu konfigurieren. In diesem Artikel wird beschrieben, wie Sie das Profilfoto eines angemeldeten Benutzers abrufen, in OneDrive hochladen und eine E-Mail mit einem Freigabelink zum Foto senden.You can use the Connected Services in Visual Studio to configure your app to call the Microsoft Graph API. This article describes how to get a signed in user's profile photo, upload it to OneDrive, and send an email with a sharing link to the photo.

EinrichtenGet set up

Um Office 365 Connected Services mit Microsoft Graph zu verwenden, müssen Sie die folgenden Schritte ausführen:To use the Office 365 Connected Services with Microsoft Graph, you'll need to do the following:

  • Laden Sie die Vorschauversion von Visual Studio 2017 herunter, sofern Sie dies noch nicht getan haben. Wenn Sie eine frühere Version von Visual Studio verwenden, können Sie die Vorschauversion Visual Studio 2017 parallel zu Ihrer aktuellen Version verwenden.Download the Visual Studio 2017 Preview, if you haven't already. If you're using an earlier version of Visual Studio, you can use Visual Studio 2017 Preview side by side with your current version.

  • Erwerben Sie ein Microsoft 365-Abonnement. Um eine kostenlose Testversion zu erhalten, nehmen Sie am Microsoft 365-Entwicklerprogramm teil.Get a Microsoft 365 subscription. To get a free trial, join the Microsoft 365 Developer program.

Abrufen des StartprojektsGet the starter project

Laden Sie das Microsoft Graph ASP.NET-Beispiel für Connected Services herunter. Dieses Beispiel enthält die Referenzen, die Sie zum Authentifizieren bei Microsoft Graph benötigen. Nachdem Sie das Startprojekt herunterladen haben, entzippen Sie es, und öffnen Sie das Beispiel in der Vorschauversion von Visual Studio 2017.Download the Microsoft Graph ASP.NET Connected Services Sample. This sample includes the references that you need to authenticate against Microsoft Graph. After you download the starter project, unzip, and open the sample in Visual Studio 2017 Preview.

Hinzufügen des verbundenen DienstsAdd the Connected Service

Nun können Sie den Microsoft Graph-Dienst zu Ihrem Visual Studio-Projekt hinzufügen.You're now ready to add the Microsoft Graph service to your Visual Studio project.

  1. Wählen Sie im Projektmappen-Explorer Verbundene Dienste aus, um die Registerkarte „Verbundene Dienste“ zu öffnen.In Solution Explorer, choose Connected Services to open the Connected Services tab.

  2. Wählen Sie den Anbieter Mit Microsoft Graph auf Office 365-Dienste zugreifen aus.Choose the Access Office 365 Services with Microsoft Graph provider. Folgen Sie den Anweisungen des Assistenten.Follow the wizard. Wählen Sie die folgenden Berechtigungen aus (Sie können die Berechtigungen später ändern):Select the following permissions (you can change the permissions later):

    • Für die Datei-APIs legen Sie die Berechtigungen auf Vollzugriff auf Ihre Dateien fest.For the File APIs, set permissions to Have full access to your files.
    • Für die E-Mail-APIs legen Sie die Berechtigungen auf E-Mails in Ihrem Namen senden fest.For the Mail APIs, set permissions to Send mail as you.
    • Für die Benutzer-APIs legen Sie die Berechtigungen auf Sie anmelden und Ihr Profil lesen fest.For the User APIs, set permissions to Sign you in and read your profile.

Aufrufen der Microsoft Graph-APICall the Microsoft Graph API

Das Startbeispiel ist für den Versand einer einfachen E-Mail konfiguriert. Sie können Microsoft Graph verwenden, um das Beispiel zu aktualisieren und eine E-Mail mit einem Link zum Profilfoto des angemeldeten Benutzers in OneDrive zu senden.The starter sample is configured to send a simple email. You can use Microsoft Graph to update the sample to send an email with a link to the signed-in user's profile photo in OneDrive.

  1. Wechseln Sie zu „Models\GraphService.cs“. Diese Datei enthält den Code zum Aufrufen von Microsoft Graph.Go to 'Models\GraphService.cs', which hosts the code to call Microsoft Graph.

  2. Suchen Sie Aufrufe des SDK in den folgenden Methoden, und kommentieren Sie sie aus. Hier wird gezeigt, wie Sie Microsoft Graph aufrufen, um ein Profilfoto abzurufen, eine Datei in OneDrive hochzuladen und einen Freigabelink zu erhalten.Find and Uncomment calls to the SDK in the following methods. This shows how to call Microsoft Graph to get a profile photo, upload a file to OneDrive, and get a sharing link.

        GetCurrentUserPhotoStream(GraphServiceClient graphClient)
    
        UploadFileToOneDrive(GraphServiceClient graphClient, byte[] file)
    
        GetSharingLink(GraphServiceClient graphClient, string Id)
    

Tipp: Jeder Kommentar beginnt mit „//Uncomment:“Tip: Each comment starts with '//Uncomment:'

Ausführen des BeispielsRun the sample

Erstellen Sie das Beispiel, und führen Sie es aus. Wählen Sie als Nächstes den Link Anmelden in der rechten oberen Ecke, und wählen Sie dann E-Mail-Adresse abrufen gefolgt von E-Mail senden.Build and run the sample. Next, choose the Sign-in link on the top right, and then choose Get email address followed by Send email.

Hierdurch wird eine E-Mail gesendet, die einen Link zu Ihrem Profilfoto enthält.This will send an email that includes a link to your profile photo.

Hinweise:Notes:

  • Wenn Sie den Vorgang beenden und das Beispiel erneut in Visual Studio ausführen, müssen Sie sich möglicherweise explizit abmelden, damit das Beispiel funktioniert.If you stop and rerun the sample from Visual Studio, you might need to explicitly sign out for the sample to work.
  • Wenn Sie eine Ausnahme erhalten, die angibt, dass der Benutzer nicht authentifiziert ist, müssen Sie möglicherweise den Schritt Hinzufügen des verbundenen Diensts wiederholen.If you get an exception that indicates that the User is not authenticated, you might need to repeat the Add the Connected Service step.

Untersuchen des CodesExplore the code

Sie können nun mithilfe von Visual Studio 2017 eine Verbindung mit Ihren Diensten herstellen und diese konfigurieren. Im Startbeispiel werden das Gerüst und die Verweise für Sie erstellt.You can now use Visual Studio 2017 to connect to and configure your services. The starter sample creates the scaffolding and references for you.

Das Startbeispiel umfasst die folgenden Dateien:The starter sample includes the following files:

Benötigen Sie Hilfe?Need help?

Wenn Sie Hilfe benötigen, veröffentlichen Sie Ihre Fragen in StackOverflow. Taggen Sie Ihren Beitrag mit {microsoftgraph}.If you need help, post your questions on StackOverflow. Tag your post with {microsoftgraph}.