ArrayList .Add 与 .AddRange 相对于管道

Question

给定一个正确定义的变量

$test = New-Object System.Collections.ArrayList

.Add 用数组中的项目数污染管道，而.AddRange 不会。 $test.Add('Single') 会将计数转储到控制台。 $test.AddRange(@('Single2')) 将毫不费力地清理干净。为什么会有不同的行为？这只是一个疏忽，还是有一些我不理解的故意行为？

鉴于.AddRange 需要在不使用变量时强制转换为数组（这已经是一个数组），当我知道我只需要添加一项时，我倾向于使用[void]$variable.Add('String')，当我知道我只需要添加一项时使用[void]$test.AddRange($variable)我正在向数组中添加一个数组，即使 $variable 仅包含或只能包含单个项目。 [void] 这里不是必需的，但我想知道拥有它是否只是最佳实践，当然取决于上面的答案。还是我也错过了什么？

Answer 1

为什么会有不同的行为？这只是一个疏忽，还是有一些我不理解的故意行为？

因为很多年前，有人决定 ArrayList 应该这样做！

Add() 返回参数插入列表的索引，这可能确实有用且有意义。

另一方面，对于AddRange()，目前还不清楚为什么它应该返回任何东西，如果是，什么？输入参数中 first 项的索引？ 最后一个？还是应该返回一个包含所有插入索引的可变大小数组？那会很尴尬！所以实现ArrayList的人决定不返回任何东西。

在C# 或VB.NET 中，ArrayList 最初是为此设计的，“污染管道”实际上并不作为一个概念存在，如果有人，运行时将简单地省略将返回值复制回调用者调用 .Add() 而不分配给变量。

这里的[void] 不是必需的，但我想知道拥有它是否只是最佳实践，当然这取决于上面的答案。还是我也错过了什么？

不，完全没有必要。 AddRange() 不是神奇地有一天会改变输出任何东西。

---

如果您不需要知道插入索引，请改用[System.Collections.Generic.List[psobject]]：

$list = [System.Collections.Generic.List[psobject]]::new()

# this won't return anything, no need for `[void]`
$list.Add(123)

---

如果出于某种原因您必须使用ArrayList，您可以通过覆盖Add() 方法来“静默”它：

function New-SilentArrayList {
  # Create a new ArrayList
  $newList = [System.Collections.ArrayList]::new()

  # Create a new `Add()` method, then return the list
  $newAdd  = @{
    InputObject = $newList
    MemberType = 'ScriptMethod' 
    Name = 'Add'
    Value = {param($obj) $this.AddRange(@($obj))}
  }
  Write-Output $( 
    Add-Member @newAdd -Force -PassThru
  ) -NoEnumerate
}

现在你的ArrayList 的Add() 再也不会偷看了！

PS C:\> $list = New-SilentArrayList
PS C:\> $list.Add(123)
PS C:\> $list
123

Answer 2

显然我没听懂你要去哪里。
“添加会污染 管道”，再想想是正确的说法但 .Net 方法如$variable.Add('String') 不 单独使用 PowerShell 管道（直到您使用 Write-Output 命令输出数组，如果您不将其分配给变量，这是默认命令）。

Write-Output cmdlet 通常在脚本中用于显示 控制台上的字符串和其他对象。但是，因为默认 行为是在管道末端显示对象，它是 一般不需要使用 cmdlet。

重点是ArrayList 的Add 方法返回[Int32]“添加值的ArrayList 索引”，而AddRange 不返回任何内容。这意味着如果您不将结果分配给其他东西（包括 $Null = $test.Add('Single')），它确实会输出到 PowerShell 管道。
相反，您也可以考虑使用 List 类的 Add 方法，该方法也不返回任何内容，另请参见：ArrayList vs List<> in C#。
但总的来说，我建议使用确实使用管道的本机 PowerShell 命令
_{（我不能给你一个很好的例子，因为不清楚你期望什么输出，但我注意到你删除的另一个问题这个问题，我想这个Why should I avoid using the increase assignment operator (+=) to create a collection 的答案可能会帮助你进一步）}