Eventi
19 nov, 23 - 21 nov, 23
Partecipa alle sessioni online di Microsoft Ignite create per espandere le tue competenze e aiutarti a risolvere i problemi complessi di oggi.
Iscriviti subitoQuesto browser non è più supportato.
Esegui l'aggiornamento a Microsoft Edge per sfruttare i vantaggi di funzionalità più recenti, aggiornamenti della sicurezza e supporto tecnico.
This article is part of step 3: review app details of the process to migrate apps.
If your app currently uses the Azure Active Directory (Azure AD) Graph client library, switch to the Microsoft Graph .NET client library.
In this article, you learn the following general steps to migrate over to the Microsoft Graph .NET client library:
The following steps assume your app uses ADAL to acquire access tokens to call Azure AD Graph. Switching to MSAL can be done as a separate step described in migrating to MSAL.
To acquire an access token to Microsoft Graph, update resourceUrl from https://graph.windows.net
to https://graph.microsoft.com
.
In your app, update references to the Microsoft Graph client library by changing:
using Microsoft.Azure.ActiveDirectory.GraphClient;
To:
using Microsoft.Graph;
Use your package manager to download and update the Microsoft Graph NuGet package and update dependencies.
Update your client constructor to create a GraphServiceClient
, rather than ActiveDirectoryClient
. The following code snippets assume your app is using the AcquireTokenAsyncForUser()
method to acquire new tokens. You can find a definition for this method as part of the active-directory-dotnet-graphapi-console sample.
Change:
ActiveDirectoryClient client = new ActiveDirectoryClient(serviceRoot,
async () => await AcquireTokenAsyncForUser());
To:
GraphServiceClient graphClient = new GraphServiceClient(serviceRoot,
new DelegateAuthenticationProvider(async (requestMessage) => {
var token = await AcquireTokenAsyncForUser();
requestMessage.Headers.Authorization = new
AuthenticationHeaderValue("bearer", token);
}));
For Microsoft Graph client library, the serviceRoot
value also includes the version number. Currently, that value is https://graph.microsoft.com/v1.0
.
Update requests to use the Microsoft Graph client request builder syntax, by changing:
signedInUser = (User)await client.Me.ExecuteAsync();
To:
signedInUser = (User)await client.Me.Request().GetAsync();
Nota
The Azure AD Graph client library supported LINQ-based query syntax. However, the Microsoft Graph client library does not. Consequently, you need to convert the relevant queries to a more RESTful expression.
To do so, change:
var groups = await
client.Groups.Where(g => g.DisplayName.StartsWith("a")).ExecuteAsync();
To:
var groups = await
client.Groups.Request().Filter("startswith(displayName,'a')").GetAsync();
If your code pages through collections, make the following minor adjustments. The following example compares and contrasts fetching a group and paging through its members, 5 at a time. While the code for Azure AD Graph requires a fetcher construct in order to fetch a group's members, Microsoft Graph has no such requirement. To be concise, only user members are displayed, try/catch and error conditions aren't shown, and the code snippets are for a single-threaded console app.
As an example, change the following code using the Azure AD Graph .NET client library:
Group retrievedGroup = client.Groups.
Where(g => g.ObjectId.Equals(id)).ExecuteAsync().Result;
IGroupFetcher retrievedGroupFetcher = (IGroupFetcher) retrievedGroup;
var membersPage = retrievedGroupFetcher.Members.Take(5).ExecuteAsync().Result;
Console.WriteLine(" Members:");
do
{
List<IDirectoryObject> members = membersPage.CurrentPage.ToList();
foreach (IDirectoryObject member in members)
{
if (member is User)
{
User memberUser = (User)member;
Console.WriteLine(" User: {0} ", memberUser.DisplayName);
}
}
membersPage = membersPage.GetNextPageAsync().Result;
} while (membersPage != null);
To the following code using the Microsoft Graph .NET client library:
var membersPage = client.Groups[id].Members.Request().Top(5).GetAsync().Result;
Console.WriteLine(" Members:");
do
{
List<DirectoryObject> members = membersPage.CurrentPage.ToList();
foreach (DirectoryObject member in members)
{
if (member is User)
{
User memberUser = (User)member;
Console.WriteLine(" User: {0} ", memberUser.DisplayName);
}
}
if (membersPage.NextPageRequest != null)
membersPage = membersPage.NextPageRequest.GetAsync().Result;
else membersPage = null;
} while (membersPage != null);
Build and fix any resource, property, navigation, and service action errors that are related to name changes.
The C# console snippets app highlights more of the differences between Microsoft Graph client library and Azure AD Graph client library.
The Azure AD Graph client library supports only the .NET platform. However, Microsoft Graph client library supports additional platforms and languages.
Eventi
19 nov, 23 - 21 nov, 23
Partecipa alle sessioni online di Microsoft Ignite create per espandere le tue competenze e aiutarti a risolvere i problemi complessi di oggi.
Iscriviti subito