Microsoft.Graph 5.56.0

Microsoft Graph .NET 客户端库

将 Microsoft Graph API 集成到您的 .NET 项目中！

Microsoft Graph .NET 客户端库针对 .NetStandard 2.0。

通过 NuGet 安装

要使用 NuGet 安装客户端库

• 在 NuGet 库中搜索 Microsoft.Graph，或
• 在包管理器控制台中输入 Install-Package Microsoft.Graph。

入门

1. 注册您的应用程序

使用 Microsoft 应用注册门户 注册您的应用程序以使用 Microsoft Graph API。

2. 对Microsoft Graph服务进行身份验证

Microsoft Graph .NET客户端库支持在Azure.Identity库中使用TokenCredential类。

您可以在此处阅读有关可用的凭据类的更多信息这里，以及如何快速设置TokenCredential实例的示例这里。

推荐用于对Microsoft Identity (Azure AD)进行身份验证的库是MSAL。

有关使用V2身份验证端点对UWP应用进行身份验证的示例，请参阅Microsoft Graph UWP Connect Library。

3. 使用身份验证提供程序创建Microsoft Graph客户端对象

GraphServiceClient类的实例负责构建请求、将它们发送到Microsoft Graph API以及处理响应。要创建此类的全新实例，您需要提供可以验证对Microsoft Graph请求的IAuthenticationProvider实例。

有关初始化客户端实例的更多信息，请参阅库概述

4. 对图进行请求

一旦完成身份验证并且有了GraphServiceClient，您就可以开始对该服务进行调用。SDK中的请求遵循Microsoft Graph API的RESTful语法格式。

例如，要检索用户的默认驱动器

var drive = await graphClient.Me.Drive.GetAsync();

如果成功，GetAsync将返回一个Drive对象并在错误时抛出ApiException。

要获取当前用户默认驱动器的根文件夹

// Get the user's driveId
var drive = await graphClient.Me.Drive.GetAsync();
var userDriveId = driveItem.Id;
// use the driveId to get the root drive
var rootItem = await graphClient.Drives[userDriveId].Root.GetAsync();

如果成功，GetAsync将返回一个DriveItem对象并在错误时抛出ApiException。

有关SDK设计的一般概述，请参阅概述。

以下是一些可用的示例应用程序

• Microsoft Graph UWP Connect 示例
• Microsoft Graph UWP Code Snippets 示例
• 适用于UWP的Microsoft Graph MeetingBot 示例
• 适用于ASP.NET 4.6的Microsoft Graph Connect 示例
• 适用于ASP.NET 4.6的Microsoft Graph Code Snippets 示例
• 适用于Xamarin.Forms的Microsoft Graph SDK Code Snippets 库
• 适用于Xamarin Forms的Microsoft Graph Connect 示例
• 适用于Xamarin.Forms的Microsoft Graph Meeting Manager 示例
• 适用于Xamarin Native的Microsoft Graph Property Manager 示例

文档和资源

• 概述
• 集合
• 错误
• 头部
• Microsoft Graph API
• 发布说明
• 博客 - 3/16/20 Microsoft Graph .NET SDK 更新

注意

v1升级

在1.x和3.x之间，有些小的问题可能会破坏功能

• .NET Standard最小版本从netStandard1.3提升到netstandard2.0
• .NET Framework最minsh版本从net45提升到net461
• GiphyRatingType枚举顺序发生变化
• ParticipantInfo变为InvitationParticipantInfo
• CallRecordRequestBody变为CallRecordResponseRequestBody

v4升级

在3.x和4.x之间有一些重大的破坏性更改

• .NET Standard最小版本从netStandard1.3提升到netstandard2.0
• .NET Framework最小版本从net45提升到net462
• 用System.Text.Json替换Newtosoft.Json
• 将Microsoft.Graph.Core依赖项升级到版本2.0.0

在此处查看升级指南这里。

v5升级

在4.x和5.x之间有一些重大的破坏性更改，因为SDK现在使用Kiota进行代码生成

在此处查看升级指南这里。

问题

要查看或记录问题，请参阅问题。

本项目采用了Microsoft 开源行为准则。想了解更多信息，请参阅行为准则FAQ，或通过[email protected]联系以提出任何附加问题或评论。

其他资源

• NuGet 包：https://nuget.net.cn/packages/Microsoft.Graph

本地构建库

如果您希望为提交代码或运行测试而本地构建库，则需要：

• 安装 .NET Core SDK (> 1.0)
• 在您的包目录中，从命令行运行 dotnet restore
• 从 CLI 运行 nuget restore 和 msbuild，或从 Visual Studio 中的“构建”选项卡还原 NuGet 包并构建项目

由于文件名较长，在克隆仓库到您的系统之前，您可能需要运行 git config --system core.longpaths true

此外，对于 Windows 操作系统，在 VS 打开解决方案之前，将注册表项 HKLM\SYSTEM\CurrentControlSet\Control\FileSystem 的参数 LongPathsEnabled 的值设置为 1

许可证

版权 (c) 微软公司。保留所有权利。在 MIT 许可下授权。有关通过 NuGet 引用的包的信息，请参阅第三方声明。