函数返回Excel COM Range对象异常：被逐个遍历而非整体处理

问题场景 #

定义如下PowerShell函数获取Excel单元格区域：

function xlAssignRange
{
    Param($shtSheet, [string]$strRange)

    $rngRange = $shtSheet.Range($strRange)

    $rngRange
    return
}

调用时：

$rngA1E10 = xlAssignRange $shtSheetOne "A1:E10"

执行$rngA1E10.Select()时，单元格会被逐个选中，最终仅停在E10；但直接执行$shtSheetOne.Range("A1:E10").Select()却能选中整个区域，符合预期。

同类异常还有复制函数：

function xlCopyRange
{
    Param($strRange)

    $strRange.Copy() | Out-Null
}

传入"E1:E10"区域后，剪贴板最终只保留E10的值，省略Out-Null可见遍历每个单元格时返回的"True"。

原因 #

PowerShell默认会自动枚举集合/数组类型的返回值，Excel的Range对象本质是包含多个单元格的集合，函数直接返回时会被拆解成单个单元格对象输出，导致后续操作逐个处理每个单元格。

解决方法 #

方法1：用逗号包裹返回值，强制作为单个对象输出 #

修改xlAssignRange函数的返回逻辑，把返回值放在数组里（用逗号前缀），让PowerShell把它当作单个元素的数组，避免枚举：

function xlAssignRange
{
    Param($shtSheet, [string]$strRange)

    $rngRange = $shtSheet.Range($strRange)

    # 用逗号包裹，强制作为单个对象返回
    ,$rngRange
    return
}

方法2：使用Write-Output -NoEnumerate输出 #

通过Write-Output的-NoEnumerate参数阻止枚举，直接返回完整对象：

function xlAssignRange
{
    Param($shtSheet, [string]$strRange)

    $rngRange = $shtSheet.Range($strRange)

    Write-Output $rngRange -NoEnumerate
    return
}

针对xlCopyRange的补充修改 #

确保传入的是未被枚举的完整Range对象，再执行Copy操作：

function xlCopyRange
{
    Param($rngRange)

    # 操作完整区域对象
    $rngRange.Copy() | Out-Null
}

调用时需保证传入的$rngRange是通过上述两种方法返回的完整对象。

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