求Microsoft.Exchange.Data.MultiValuedProperty最新文档及与泛型列表等对比信息

当前现状 #

Exchange 2016的PowerShell cmdlet返回数据里，会用到Microsoft.Exchange.Data.MultiValuedProperty类型，但目前找不到该类型的官方最新文档，仅能获取到已弃用的旧版文档。

类型对比信息 #

与System.Collections.Generic.List<T>的差异 #

• 业务绑定：MultiValuedProperty是Exchange数据模型专属类型，和Exchange对象的属性变更追踪、验证逻辑深度绑定，修改元素时会自动触发Exchange对象的属性更新校验；List<T>是通用集合，无此类内置业务逻辑。
• 序列化适配：该类型针对Exchange的序列化/反序列化机制做了优化，可直接适配Exchange存储与PowerShell输出的格式转换；List<T>需要额外处理才能兼容Exchange数据层。
• API特性：MultiValuedProperty提供了Exchange专属的方法（如带业务逻辑的AddRange重载、属性变更检测），但通用集合方法的支持度不如List<T>全面。

与System.Collections.ArrayList的差异 #

• 类型安全：MultiValuedProperty是泛型类型（MultiValuedProperty<T>），具备类型安全特性；ArrayList是非泛型集合，存储的是object类型，存在装箱拆箱开销和类型转换风险。
• 业务适配：同样绑定Exchange的属性验证逻辑，ArrayList无任何Exchange相关内置支持，仅作为通用非泛型集合使用。
• 性能表现：得益于泛型特性，MultiValuedProperty在类型操作上的性能优于ArrayList，且避免了非泛型集合的类型转换问题。

实用转换方法 #

如果需要将MultiValuedProperty转换为通用集合以便灵活操作，可使用以下PowerShell命令：

# 转换为List<T>
$list = $exchangeObject.TargetMultiValuedProperty.ToList()

# 转换为ArrayList
$arrayList = New-Object System.Collections.ArrayList
$arrayList.AddRange($exchangeObject.TargetMultiValuedProperty)

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