如何在PnP Core中加载SharePoint列表项的Person字段Email属性？

云上老周

2026-7-13

在PnP Core中展开Person/Lookup复杂字段的解决方案

要加载Person字段的Email等关联属性，你需要在查询列表项时显式指定要展开的字段，并选择需要的属性，逻辑和PnP JS里的expand+select一致，具体实现如下：

方法1：直接链式调用Expand和Select

// 获取目标列表
var myList = await context.Web.Lists.GetByTitleAsync("My List");

// 查询列表项，展开Person字段并指定要加载的属性
await foreach (var listItem in myList.Items.Expand("MyOwner").Select("MyOwner/Email, MyOwner/Title"))
{
    var ownerValue = listItem.Values["MyOwner"] as FieldUserValue;
    if (ownerValue != null)
    {
        Console.WriteLine($"用户邮箱：{ownerValue.Email}");
        Console.WriteLine($"用户名称：{ownerValue.Title}");
    }
}

方法2：结合CAML查询使用

如果需要添加筛选等复杂逻辑，可以配合CAML查询实现：

var myList = await context.Web.Lists.GetByTitleAsync("My List");

// 构造CAML查询（示例：筛选非空的MyOwner字段）
var camlQuery = new CamlQuery()
{
    ViewXml = "<View><Query><Where><IsNotNull><FieldRef Name='MyOwner' /></IsNotNull></Where></Query></View>"
};

// 执行查询时配置展开和属性选择
var items = await myList.GetItemsByCamlQueryAsync(camlQuery, 
    p => p.Expand("MyOwner").Select("MyOwner/Email, MyOwner/Id"));

foreach (var listItem in items)
{
    var ownerValue = listItem.Values["MyOwner"] as FieldUserValue;
    if (ownerValue != null)
    {
        Console.WriteLine($"用户邮箱：{ownerValue.Email}");
    }
}