编写 PowerShell cmdlet 时，WriteObject(x, true) 和多个 writeobject 有什么区别？

Question

我想编写一个 cmdlet，从数据库读取多条记录并将它们放入管道中。

我想我可以执行单个 WriteObject(Enumerable, true) 或者我可以循环自己并多次调用 WriteObject 。

这两者有什么区别？

Answer 1

以下是文档： Cmdlet.WriteObject 方法 ( Object, Boolean)

下面是示例：

# Writes objects one by one
function Test1
{
    [CmdletBinding()]param()
    $data | %{ $PSCmdlet.WriteObject($_) }
}

# Writes the collection and allows the core to enumerate it one level.
# Numbers of written objects is the collection item count.
function Test2
{
    [CmdletBinding()]param()
    $PSCmdlet.WriteObject($data, $true)
}

# Writes the collection as a single object.
# Numbers of written objects is 1.
function Test3
{
    [CmdletBinding()]param()
    $PSCmdlet.WriteObject($data, $false)
}

function Test
{
    (Test1).GetType().Name
    (Test2).GetType().Name
    (Test3).GetType().Name
}

$data = New-Object System.Collections.ArrayList

Write-Host "1 item"
$null = $data.Add('hello')
Test

Write-Host "2+ items"
$null = $data.Add('world')
Test

输出：

1 item
String
String
ArrayList
2+ items
Object[]
Object[]
ArrayList

因此，为集合中的每个项目调用 WriteObject(item) 基本上与WriteObject(items, true);在这两种情况下，收藏品本身都消失了。

WriteObject(items, false) 是不同的；它返回对集合的引用，调用者可以根据场景有效地使用它。例如，如果集合是 DataTable 对象（不是展开的 DataRow 项集），则调用者可以对返回的 DataTable 成员进行操作目的。

Answer 2

那么，WriteObject(Object, boolean) 将允许您输出一个集合并使其保持完整（如果使用第二个参数“false”调用）。通常，PowerShell 会枚举放入管道的所有集合。

因此，您可以输出一个字符串数组，结果将是 [String[]] 类型。而如果让 PowerShell 解开它，它将是 [Object[]] 中的字符串数组。

您还可以使用“true”来调用该重载，它就像调用 WriteObject(Object) 的循环一样。