使用Graph API C#更新SharePoint DriveItem元数据字段异常问题

问题重现 #

使用Graph API更新SharePoint DriveItem对应ListItem的字段时，出现以下异常：

• 仅更新多选托管元数据+选项/人员字段时，所有字段可正常填充
• 同时包含单选托管元数据时，仅元数据字段生效，其余选项/人员字段被清空
• 仅更新单选托管元数据+其他字段时，仅单选元数据字段生效

构建的FieldValueSet对象及更新代码如下：

fieldvalueset = new FieldValueSet
{
    AdditionalData = new Dictionary<string, object>()
                {
                    {"aeaaa8de8b8c4df99f251ec41b221cb5",termreferences},
                    {"c9e01cf2707746118721ab0ba03d23a7", directortermreferences},
                    {"fec9fa55dcc34d41a5eae8927e5fb90d",SectionTermRef },
                    {"Document_x0020_Type","BTOR" },
                    {"Prepared_x0020_ByLookupId",userLookupId },
                    {"State","Draft" }
                }
};

var updatefield= await graph
              .Sites[siteId]
              .Drives[DriveId]
              .Items[Driveitem.Id]
              .ListItem
              .Fields
              .Request()
              .UpdateAsync(fieldvalueset);

字段类型说明：

• termreferences：多选托管元数据查找
• directortermreferences/SectionTermRef：单选托管元数据查找
• Document_x0020_Type/State：选项类型字段
• Prepared_x0020_ByLookupId：人员与组类型字段

元数据拼接存在语法错误：

// 多选元数据拼接错误示例
if(termreferences=="")
{
    termreferences = "-1;#" + term.Label + "|" + term.TermGuid;
}
else
{
    // 引号拼接错误导致格式无效
    termreferences= termreferences+";#+"-1;#" + term.Label + "|" + term.TermGuid;
}

解决方案 #

1. 修复多选托管元数据的格式错误 #

多选托管元数据需用;#分隔每个条目，每个条目格式为-1;#标签|术语GUID，修正拼接逻辑：

var termReferencesList = new List<string>();
foreach(var term in targetTerms)
{
    termReferencesList.Add($"-1;# {term.Label}|{term.TermGuid}");
}
var termreferences = string.Join(";#", termReferencesList);

通过集合拼接避免手动字符串拼接的语法错误，保证格式符合SharePoint要求。

2. 匹配字段类型的格式要求 #

• 单选托管元数据：当前格式-1;#标签|术语GUID正确，需确认术语GUID和标签准确
• 人员与组字段：若使用LookupId后缀的字段名，直接传入整数类型的用户ID（确保userLookupId为整数而非字符串）
• 选项字段：需传入选项的内部值（而非显示文本），确认"BTOR"和"Draft"是字段定义的内部值

3. 合并更新避免字段覆盖 #

UpdateAsync为全量更新，未指定的字段会被覆盖。如需保留原有字段值，先获取当前字段值再合并更新：

// 1. 获取当前ListItem的所有字段值
var existingFields = await graph
    .Sites[siteId]
    .Drives[DriveId]
    .Items[Driveitem.Id]
    .ListItem
    .Fields
    .Request()
    .GetAsync();

// 2. 合并新字段值到现有字典
var mergedFields = new Dictionary<string, object>(existingFields.AdditionalData);
mergedFields["aeaaa8de8b8c4df99f251ec41b221cb5"] = termreferences;
mergedFields["c9e01cf2707746118721ab0ba03d23a7"] = directortermreferences;
mergedFields["fec9fa55dcc34d41a5eae8927e5fb90d"] = SectionTermRef;
mergedFields["Document_x0020_Type"] = "BTOR";
mergedFields["Prepared_x0020_ByLookupId"] = userLookupId;
mergedFields["State"] = "Draft";

// 3. 提交合并后的字段更新
var updatedFieldSet = new FieldValueSet { AdditionalData = mergedFields };
var updateResult = await graph
    .Sites[siteId]
    .Drives[DriveId]
    .Items[Driveitem.Id]
    .ListItem
    .Fields
    .Request()
    .UpdateAsync(updatedFieldSet);

4. 确认字段内部名称正确性 #

AdditionalData中的字段键必须是SharePoint字段的内部名称（可通过站点设置→列表设置→字段属性查看），避免因名称错误导致字段未被识别。

验证步骤 #

1. 单独测试单选托管元数据+单个选项字段，确认字段可正常更新
2. 逐步添加其他字段，定位是否存在特定字段格式冲突
3. 使用Graph Explorer发送PATCH请求，直接传入JSON格式字段值，排查代码层面的格式问题

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