PnP Core标准对象为内部密封类，如何创建可扩展自定义基础类？

因为PnP Core的标准实体类都是internal sealed，无法直接继承扩展，不过可以通过以下几种规范方式实现自定义功能，避免重复实现全部接口逻辑：

1. 使用装饰器模式（Decorator Pattern） #

基于PnP提供的接口，创建装饰器类包装原有对象，只扩展需要的功能，复用原有对象的核心逻辑：

public class CustomListItem : IListItem
{
    private readonly IListItem _innerListItem;
    // 自定义属性
    public string CustomProperty { get; set; }

    public CustomListItem(IListItem innerListItem)
    {
        _innerListItem = innerListItem ?? throw new ArgumentNullException(nameof(innerListItem));
    }

    // 复用原有接口的实现，直接转发调用
    public Guid Id => _innerListItem.Id;
    public string Title
    {
        get => _innerListItem.Title;
        set => _innerListItem.Title = value;
    }
    // 其他接口成员同理，全部转发到_innerListItem
}

使用时直接包装从PnP获取的实例：

var listItem = await context.Web.Lists.GetByTitle("Documents").Items.FirstAsync();
var customItem = new CustomListItem(listItem);
customItem.CustomProperty = "自定义内容";

2. 扩展方法（Extension Methods） #

如果只需要添加额外的行为（而非属性），扩展方法是最轻量的方案，无需创建新类：

public static class ListItemExtensions
{
    public static async Task Archive(this IListItem item)
    {
        // 实现归档逻辑，比如修改状态字段、移动到归档库等
        item["Status"] = "Archived";
        await item.UpdateAsync();
    }

    public static string GetFullPath(this IListItem item)
    {
        return $"{item.ParentList.Title}/{item.Title}";
    }
}

直接调用即可：

var listItem = await context.Web.Lists.GetByTitle("Documents").Items.FirstAsync();
await listItem.Archive();
var path = listItem.GetFullPath();

3. 附加属性存储（利用PnP的扩展字段或字典） #

如果需要添加自定义属性，可以借助PnP对象的AdditionalData字典（多数实体接口都包含这个属性），无需创建新类：

var listItem = await context.Web.Lists.GetByTitle("Documents").Items.FirstAsync();
// 存储自定义属性
listItem.AdditionalData["CustomMetadata"] = new { Author = "TixmTV", Date = DateTime.Now };
// 读取自定义属性
var customMeta = (dynamic)listItem.AdditionalData["CustomMetadata"];
Console.WriteLine(customMeta.Author);

如果需要持久化自定义属性，可以在SharePoint列表中创建对应的字段，通过item["CustomFieldInternalName"]直接读写，这是最贴合PnP生态的持久化扩展方式。

4. 自定义实体映射 #

如果需要更独立的自定义对象，可以创建自己的实体类，通过映射方法和PnP的接口对象互转：

public class MyCustomListItem
{
    public Guid Id { get; set; }
    public string Title { get; set; }
    public string CustomTag { get; set; }

    // 从PnP IListItem映射
    public static MyCustomListItem FromPnPListItem(IListItem item)
    {
        return new MyCustomListItem
        {
            Id = item.Id,
            Title = item.Title,
            CustomTag = item["CustomTag"]?.ToString()
        };
    }

    // 映射回PnP IListItem
    public void ToPnPListItem(IListItem item)
    {
        item.Title = Title;
        item["CustomTag"] = CustomTag;
    }
}

使用时：

var pnpItem = await context.Web.Lists.GetByTitle("Documents").Items.FirstAsync();
var myItem = MyCustomListItem.FromPnPListItem(pnpItem);
myItem.CustomTag = "Important";
myItem.ToPnPListItem(pnpItem);
await pnpItem.UpdateAsync();

以上几种方案各有适用场景：

• 扩展方法适合添加通用行为
• 装饰器适合需要封装额外属性+复用原有逻辑的场景
• AdditionalData适合临时存储自定义数据
• 自定义实体映射适合需要完全独立的业务对象模型

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