大网数据广告活动
Microsoft Graph 接口

将 Azure Active Directory (Azure AD) Graph .NET 应用迁移到 Microsoft Graph

· 52CE 我爱测

- 如何创建 Microsoft Graph 客户端(给定访问令牌 (您可以使用 Azure Active Directory 身份验证库 (ADAL) 或 Microsoft 身份验证库 (MSAL) ) - 如何制定请求 - 如何使用查询生成器 - 如何处理集合和分页

本文是步骤 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 中所述的单独 步骤完成。

  1. 若要获取 Microsoft Graph访问令牌,请从 将 resourceUrl 更新 https://graph.windows.net 为 https://graph.microsoft.com 。

  2. 在应用中,通过更改以下Graph Microsoft 客户端库的引用:

    using Microsoft.Azure.ActiveDirectory.GraphClient;
    

    收件人:

    using Microsoft.Graph;
    
  3. 使用程序包管理器下载和更新 Microsoft Graph NuGet程序包和更新依赖项。

  4. 更新客户端构造函数以创建 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 。

  5. 更新请求以使用 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();
    
  6. 如果代码对集合进行页面浏览,则进行以下细微的调整。 以下示例将一个组提取和分页及其成员(一次 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);
    
    
  7. 生成并修复任何资源、属性、导航和服务操作错误,通常与名称更改相关。

另请参阅

此C#代码段应用重点介绍了 Microsoft Graph 客户端库和 Azure AD Graph库之间的更多差异。

Azure AD Graph客户端库仅支持 .NET 平台。 但是,microsoft Graph客户端库支持其他平台和语言,您可能会发现这些平台和语言对解决方案更有用。

后续步骤

历史资料。此文对应 2023-02-03 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者(原始作者元数据 dkershaw10)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体、发布器占位标签和导航标记。

资料来源与适用范围

资料来源
Microsoft / Microsoft Graph 中文文档历史快照
适用范围
历史中文快照 2023-02-03;详见原文产品版本;文档日期 未标明
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。