PowerShell 如何为自定义对象属性添加多对象集合并支持动态追加

一、多对象集合类型属性的添加方法 #

针对你基于PowerShell构建SSIS元数据对象模型的场景，两类常用实现方式都适配你逐段解析XML的流程：

• 轻量快速实现：基于[PSCustomObject]构建对象时，直接将集合属性初始化为可动态扩容的泛型列表，示例代码如下：

# 初始化SSIS包顶层对象
$Package = [PSCustomObject]@{
    Name = "SalesDataLoad.dtsx"
    Path = "D:\SSIS\Production\SalesDataLoad.dtsx"
    Type = "Package"
    # 预初始化连接管理器集合为可动态扩容的对象列表
    ConnectionManagers = [System.Collections.Generic.List[object]]::new()
}

# 初始化单连接管理器对象时，同步预初始化其下属的表达式集合
$SampleConnectionManager = [PSCustomObject]@{
    ID = "CM_OLEDB_Source"
    ConnectionString = "Provider=SQLNCLI11;Server=ProdSQL01;Initial Catalog=SalesDB;"
    # 预初始化表达式集合
    Expressions = [System.Collections.Generic.List[object]]::new()
}

• 强约束规范化实现：如果需要严格限定集合内的对象结构，避免后续导出时出现字段混乱，可以用PowerShell 5.1+支持的类定义固定对象结构，把集合属性直接定义为强类型列表：

# 先定义表达式结构
class SSISExpression {
    [string]$TargetProperty
    [string]$ExpressionText
}
# 定义连接管理器结构
class SSISConnectionManager {
    [string]$ID
    [string]$ConnectionString
    [System.Collections.Generic.List[SSISExpression]]$Expressions = @()
}
# 定义SSIS包结构
class SSISPackage {
    [string]$Name
    [string]$Path
    [string]$Type
    [System.Collections.Generic.List[SSISConnectionManager]]$ConnectionManagers = @()
}

# 实例化后即可直接使用，结构稳定性更强
$Package = [SSISPackage]@{
    Name = "SalesDataLoad.dtsx"
    Path = "D:\SSIS\Production\SalesDataLoad.dtsx"
    Type = "Package"
}

二、集合属性的赋值规则 #

这类集合属性没有强制要求必须一次性完成全部对象赋值，两种赋值方式可以根据你的解析流程灵活混用：

• 如果你在解析XML的初始阶段就已经拿到了全部关联对象的完整信息，完全可以在对象初始化的时候一次性把所有元素赋值给集合属性，减少后续的操作步骤。
• 如果你是逐节点遍历SSIS的XML结构（比如按节点层级先遍历包、再遍历连接管理器、最后遍历表达式子节点），完全可以采用分次追加的方式往集合里塞对象，这种逐节点处理的流程反而更适配XML解析的逻辑。

实操层面需要注意几个容易踩的坑：

• 一定要给集合属性初始化空容器，不要留null值，不然第一次往集合里加元素时会报“无法在空值上调用方法”的错误。
• 尽量用可动态扩容的列表（比如泛型List[object]、ArrayList）做集合容器，不要用定长数组（比如[object[]]::new(5)），不然遇到实际节点数量和预期不一致的情况时，会因为数组长度固定没法追加元素。
• 不要直接用普通PowerShell弱类型数组（@()）存元素，虽然也能通过+=追加元素，但每次追加都会重新生成整个数组，遇到SSIS包结构复杂、节点多的时候会出现不必要的性能损耗。
• 集合里存的是对象的引用而非副本，后续修改集合内的连接管理器、表达式对象的属性时，所有引用该对象的位置都会同步更新，这个特性在做跨包元数据关联、一致性检查时非常好用。

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