本文是步骤 3:查看应用程序迁移过程的详细信息的一部分。
如果你的应用当前使用 Azure AD Azure Active Directory (客户端) Graph,请切换到 Microsoft Graph .NET 客户端库。
注意:Microsoft Graph .NET 客户端库仅支持 .NET Framework 4.5 和 .NET Standard 1.1。 但是,请咨询 Microsoft Graph .NET 客户端库,获取最新的支持信息。
下面我们将了解迁移到 Microsoft Graph .NET 客户端库的一些常规步骤:
- 如何创建 Microsoft Graph 客户端(给定访问令牌 (您可以使用 Azure Active Directory 身份验证库 (ADAL) 或 Microsoft 身份验证库 (MSAL) )
- 如何制定请求
- 如何使用查询生成器
- 如何处理集合和分页
迁移步骤概述
以下步骤假定你的应用已使用 ADAL 获取访问令牌来调用 Azure AD Graph,并且目前你将继续使用 ADAL。 切换到 MSAL 可以迁移到 MSAL 中所述的单独 步骤完成。
-
若要获取 Microsoft Graph访问令牌,请从 将 resourceUrl 更新
https://graph.windows.net为https://graph.microsoft.com。 -
在应用中,通过更改以下Graph Microsoft 客户端库的引用:
using Microsoft.Azure.ActiveDirectory.GraphClient;收件人:
using Microsoft.Graph; -
使用程序包管理器下载和更新 Microsoft Graph NuGet程序包和更新依赖项。
-
更新客户端构造函数以创建
GraphServiceClient,而不是ActiveDirectoryClient。 以下代码段假设你的应用使用 方法AcquireTokenAsyncForUser()获取新令牌。 您可以在 active-directory-dotnet-graphapi-console示例中查找此方法的定义。更改:
ActiveDirectoryClient client = new ActiveDirectoryClient(serviceRoot, async () => await AcquireTokenAsyncForUser());收件人:
GraphServiceClient graphClient = new GraphServiceClient(serviceRoot, new DelegateAuthenticationProvider(async (requestMessage) => { var token = await AcquireTokenAsyncForUser(); requestMessage.Headers.Authorization = new AuthenticationHeaderValue("bearer", token); }));对于 Microsoft Graph客户端库,
serviceRoot该值还包括版本号。 目前,该值为https://graph.microsoft.com/v1.0。 -
更新请求以使用 Microsoft Graph客户端请求生成器语法,方法为:
signedInUser = (User)await client.Me.ExecuteAsync();收件人:
signedInUser = (User)await client.Me.Request().GetAsync();NOTE Azure AD Graph客户端库支持基于 LINQ 的查询语法。 但是,Microsoft Graph客户端库不会。 因此,您需要将相关查询转换为更 RESTful 表达式。
为此,请更改:
var groups = await client.Groups.Where(g => g.DisplayName.StartsWith("a")).ExecuteAsync();收件人:
var groups = await client.Groups.Request().Filter("startswith(displayName,'a')").GetAsync(); -
如果代码对集合进行页面浏览,则进行以下细微的调整。 以下示例将一个组提取和分页及其成员(一次 5 个)进行比较。 虽然 Azure AD Graph需要提取程序构造才能提取组的成员,但 Microsoft Graph没有此类要求。 除了这一点外,代码相对类似。 为简洁明了,只显示用户成员,不显示尝试/捕获和错误条件,并且代码段适用于单线程控制台应用。
例如,使用 Azure AD 和 .NET 客户端库Graph代码:
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);对于以下使用 Microsoft Graph .NET 客户端库的代码:
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); -
生成并修复任何资源、属性、导航和服务操作错误,通常与名称更改相关。
另请参阅
此C#代码段应用重点介绍了 Microsoft Graph 客户端库和 Azure AD Graph库之间的更多差异。
Azure AD Graph客户端库仅支持 .NET 平台。 但是,microsoft Graph客户端库支持其他平台和语言,您可能会发现这些平台和语言对解决方案更有用。
后续步骤
历史资料。此文对应 2023-02-03 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者(原始作者元数据 dkershaw10)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体、发布器占位标签和导航标记。
