使用C#（Microsoft.SharePoint.Client）向SharePoint文件夹添加新用户并分配权限的问题

我太懂你现在的困扰了——在SharePoint网页端用「共享」功能给文件夹加新用户（尤其是外部用户）顺得不行，一发邀请对方就能收到，权限也能正常设置；但换成用C#的Microsoft.SharePoint.Client库写代码实现时，却反复报「用户不存在」的错，完全卡壳对吧？

其实问题出在网页端的「共享」功能是一套完整的流程：它会自动检测用户是否已存在于SharePoint中，如果是新用户（比如外部邮箱），会先触发邀请流程把用户加入到站点用户列表，再分配权限；但咱们直接写代码时，要是跳过了「邀请用户」这一步，直接去查找还未被邀请的用户，自然会找不到。

接下来给你梳理下修正后的完整步骤和代码，帮你解决这个问题：

核心思路 #

1. 先处理目标文件夹的权限继承：如果文件夹当前继承父级权限，得先中断继承，才能给单个用户设置独立权限（如果不需要继承的话）。
2. 针对新用户（尤其是外部用户）：先调用SharePoint的邀请接口，把用户加入站点用户列表，拿到有效的用户对象。
3. 绑定对应的权限角色（比如读取、编辑），将用户添加到文件夹的权限集合中。

修正后的代码示例 #

// 假设你的Client上下文已经正确初始化（Client是ClientContext实例）
string folderName = "目标文件夹名称";
string targetUserEmail = "new.user@example.com";
string invitationNote = "欢迎访问该文件夹";

try
{
    // 1. 加载目标文件夹
    Folder accountFolder = AVIFolder.Folders.GetByUrl(Uri.EscapeDataString(folderName));
    Client.Load(accountFolder);
    Client.ExecuteQuery();

    // 2. 中断文件夹的权限继承（如果需要独立权限，可选步骤）
    // 第一个参数true表示保留父级现有权限，false则清空；第二个参数设为false即可
    accountFolder.ListItemAllFields.BreakRoleInheritance(true, false);
    Client.ExecuteQuery();

    // 3. 邀请新用户（外部用户专用，内部用户可直接用Web.EnsureUser）
    User invitedUser = Client.Web.CreateUserInvitation(
        targetUserEmail,
        invitationNote,
        true, // 是否自动发送邀请邮件
        string.Empty // 可选：用户的显示名称，留空则用邮箱前缀
    );
    Client.Load(invitedUser);
    Client.ExecuteQuery();

    // 4. 获取要分配的权限角色（这里以「读取」权限为例）
    // 也可以用GetById或GetByName获取自定义角色
    RoleDefinition targetRole = Client.Web.RoleDefinitions.GetByType(RoleType.Reader);
    Client.Load(targetRole);
    Client.ExecuteQuery();

    // 5. 创建角色绑定集合
    RoleDefinitionBindingCollection roleBindings = new RoleDefinitionBindingCollection(Client);
    roleBindings.Add(targetRole);

    // 6. 将用户和权限绑定添加到文件夹的权限列表中
    accountFolder.ListItemAllFields.RoleAssignments.Add(invitedUser, roleBindings);
    Client.ExecuteQuery();

    Console.WriteLine("用户邀请及权限分配成功！");
}
catch (Exception ex)
{
    Console.WriteLine($"操作失败：{ex.Message}");
}

关键注意事项 #

• 内部用户的处理：如果是企业内部用户（已在Azure AD或AD中），不需要调用CreateUserInvitation，直接用Client.Web.EnsureUser(targetUserEmail)就能获取用户对象，这个方法会自动查找或创建内部用户。
• 权限继承的选择：如果你的文件夹需要保留父级的所有权限，只需要新增用户权限，那中断继承时第一个参数设为true；如果要完全独立设置权限，设为false清空现有权限。
• 权限角色的选择：除了RoleType.Reader，还有RoleType.Editor（编辑）、RoleType.Administrator（管理员）等，也可以通过Client.Web.RoleDefinitions.GetByName("自定义角色名称")获取自定义角色。
• 权限检查：确保你的Client上下文使用的账户拥有「管理权限」或「邀请外部用户」的权限，否则会报权限不足的错误。

原来你代码里的问题，大概率是直接去查找了还未被邀请的用户（比如用SiteUsers.GetByEmail），但这个方法只能找到已经存在于站点用户列表中的用户，自然会报「用户不存在」的错。现在换成先邀请再分配的流程，就能和网页端的「共享」功能效果一致了。

备注：内容来源于stack exchange，提问作者M. Ulus