PnP Core问题：无法修改ListItem属性且无错误提示

问题描述 #

尝试修改SharePoint ListItem的自定义属性，但操作后属性未保存，且无任何错误提示。已尝试两种更新方式：listItem.UpdateAsync() 和 listItem.Properties.UpdateAsync()，均未成功。

代码片段 #

listItem.Properties["myProp"] = "myValue";

完整代码示例 #

using var context = await PnpContextFactory.GsCreateContextAsync(
        "https://xxxxxxxxxx.sharepoint.com/sites/xxxxxxxxxxxx");

var list = await context.Web.GsGetListAsync("/sites/xxxxxxxxx/xxxxxx");

var listItem = await list.Items.GetByIdAsync(6);
await listItem.LoadAsync(i => i.Properties);

listItem.Properties["myTestProp"] = "myTestValue";

await listItem.UpdateOverwriteVersionAsync();
await listItem.Properties.UpdateAsync();

注：上下文创建和列表获取的基础类在其他项目中稳定运行。

解决思路 #

• 核对字段内部名称：自定义字段的内部名称和显示名称可能不一致，确保myTestProp是字段的内部名称（而非显示名称）。可通过SharePoint列表设置的字段详情查看，或用PnP查询字段信息确认。
• 移除重复更新调用：代码中同时调用UpdateOverwriteVersionAsync()和Properties.UpdateAsync()可能引发冲突，只需保留其中一个即可。推荐使用UpdateOverwriteVersionAsync()（无需创建新版本）或UpdateAsync()，更新ListItem本身会同步Properties的修改。
• 检查字段编辑权限：确认该自定义字段未被设置为“禁止编辑”，且在列表内容类型中未标记为只读。
• 添加错误捕获排查：将更新代码包裹在try-catch块中，捕获PnPException或HttpRequestException，查看是否存在隐藏错误：

  try
  {
      listItem.Properties["myTestProp"] = "myTestValue";
      await listItem.UpdateOverwriteVersionAsync();
      await context.SaveChangesAsync(); // 显式提交上下文修改
  }
  catch (Exception ex)
  {
      Console.WriteLine(ex.Message);
      if (ex is PnPException pnpEx)
      {
          Console.WriteLine(pnpEx.ServerErrorMessage);
      }
  }
  

• 显式保存上下文：部分场景下，PnP Context需要显式调用context.SaveChangesAsync()来提交所有挂起的修改。
• 匹配字段类型：确保赋值的myTestValue类型与字段定义类型一致（如单行文本字段不能赋值数字），类型不匹配可能导致静默失败。

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