如何通过PnP Core提前检查用户上传文件到SharePoint文件夹的权限？

可以在上传前直接检查用户权限，PnP Core提供了轻量级的API来实现，比等到上传失败再处理更友好。以下是具体实现方案：

一、优先推荐：直接检查核心权限 #

SharePoint中上传文件依赖的核心权限是明确的，直接检查这些权限比检查角色组更精准（避免自定义角色组漏判的情况）：

• AddListItems：允许在文件夹中添加新文件
• OpenItems：确保用户能访问目标文件夹
• EditListItems：如果需要覆盖已有文件，需额外检查此权限

代码示例 #

using PnP.Core.Model.Security;
using PnP.Core.Model.SharePoint;

// 假设已通过用户选择拿到目标文件夹的服务器相对路径
var targetFolder = await context.Web.GetFolderByServerRelativeUrlAsync("/sites/YourSite/Shared Documents/TargetFolder");

// 检查基础上传所需权限
var uploadPermissionCheck = await targetFolder.CheckPermissionsAsync(
    PermissionKind.AddListItems, 
    PermissionKind.OpenItems
);

if (uploadPermissionCheck.HasAllPermissions)
{
    // 用户具备上传权限，执行上传逻辑
    await UploadFileToFolder(targetFolder, localFilePath);
}
else
{
    // 权限不足，提示用户
    MessageBox.Show("您没有该文件夹的文件上传权限，请联系管理员。");
}

// 如果需要支持覆盖文件，额外检查编辑权限
var overwritePermissionCheck = await targetFolder.CheckPermissionsAsync(PermissionKind.EditListItems);
if (overwritePermissionCheck.HasPermission(PermissionKind.EditListItems))
{
    // 允许覆盖已有文件
}

二、备选方案：检查用户的角色/权限组 #

如果需要明确用户所属的权限角色（比如是否是贡献者），可以获取文件夹的权限分配并验证：

代码示例 #

// 获取目标文件夹的权限集合
var folderPermissions = await targetFolder.GetPermissionsAsync();

bool hasUploadPermission = false;
foreach (var roleAssignment in folderPermissions)
{
    var roleDefinition = await roleAssignment.RoleDefinition.GetAsync();
    // 检查角色是否包含上传所需权限（这里以默认贡献者角色为例）
    if (roleDefinition.Name.Equals("Contribute", StringComparison.OrdinalIgnoreCase))
    {
        var principal = await roleAssignment.Member.GetAsync();
        // 检查当前用户是否在该权限组/用户集中
        if (principal is IUser user && user.LoginName == context.CurrentUser.LoginName)
        {
            hasUploadPermission = true;
            break;
        }
        // 处理用户组的情况（简化版，实际可递归检查嵌套组）
        else if (principal is IGroup group)
        {
            hasUploadPermission = await context.Web.IsCurrentUserInGroupAsync(group.Id);
            if (hasUploadPermission) break;
        }
    }
}

if (hasUploadPermission)
{
    // 执行上传逻辑
}

注意事项 #

• 权限继承自动处理：CheckPermissionsAsync会自动识别文件夹是否继承父级/站点权限，无需额外判断继承关系。
• 兜底异常处理：即使做了前置检查，仍可能出现检查后权限变更的情况，上传逻辑中仍需保留权限异常捕获。
• 性能对比：直接检查权限的API是轻量级请求，比获取全量权限分配的性能更高，适合前置校验场景。

内容的提问来源于stack exchange，提问作者EMaster