WinForms/PowerShell：不同运行空间下对象无法添加到父对象

背景 #

我通过以下代码将Get-UsersFolders函数导入到运行空间：

$Definition = Get-Content function:\Get-UsersFolders -ErrorAction Stop
$SessionStateFunction = New-Object System.Management.Automation.Runspaces.SessionStateFunctionEntry -ArgumentList 'Get-UsersFolders', $Definition
$InitialSessionState.Commands.add($SessionStateFunction)

该函数的具体实现如下：

function Get-UsersFolders($ComputerName) {
    #If there is any checkboxes present, delete them
    $Indexes = @()
    Foreach ($control in $hash.sourceTab.Controls) {
        if ($control.GetType().ToString() -eq "System.Windows.Forms.CheckBox") {
            $Indexes += $control.TabIndex
        }
    }
    Foreach ($index in $indexes | Sort-Object -Descending) {
        $hash.sourceTab.Controls.RemoveAt($index)
    }


    if ($null -ne $ComputerName) {
        $global:UserFolders = Invoke-Command -ComputerName $ComputerName -Credential $script:hash.credentials -ScriptBlock {
            $array = @()
            $users = Get-ChildItem -path "C:\users" | Where-Object { $_.Name -match "^\d{6}$" }
            Foreach ($folder in $users) {
                $array += [PSCUSTOMOBJECT]@{
                    Name = "$($folder.Name)" 
                    Size = "$( [Math]::Round(((Get-ChildItem $folder.fullname -Recurse -ErrorAction SilentlyContinue | Measure-Object -Sum Length -ErrorAction SilentlyContinue).Sum / 1GB),2) ) GB"
                }
            }
            Return $array
        }
    }
    else {
        $global:UserFolders = @()
        $users = Get-ChildItem -path "C:\users" | Where-Object { $_.Name -match "^\d{6}$" }
        Foreach ($folder in $users) {
            $global:UserFolders += [PSCUSTOMOBJECT]@{
                Name = "$($folder.Name)" 
                Size = "$( [Math]::Round(((Get-ChildItem $folder.fullname -Recurse -ErrorAction SilentlyContinue | Measure-Object -Sum Length -ErrorAction SilentlyContinue).Sum / 1GB),2) ) GB"
            }
        }
    }
    
    $xPos = 0
    $yPos = 0
    $numUsers = 0
    Foreach ($user in $global:UserFolders | Sort-Object -Property Size -Descending) {
        $hash.userCB = New-Object System.Windows.Forms.CheckBox
        $hash.userCB.Name = $user.Name
        $CBLx = 10 + $xPos
        $CBLy = 10 + $yPos
        $hash.userCB.Location = New-Object System.Drawing.Point($CBLx, $CBLy)
        $hash.userCB.AutoSize = $true
        $hash.userCB.Text = "$($user.Name) - ($($user.Size))"
        $hash.userCB.Tag = "$($user.Size.split(" ")[0])"
        $hash.userCB.Add_CheckStateChanged({
                Get-PrecheckTotal
                if ($null -ne $global:driveInfo) {
                    $hash.sizeAfterLabel.text = "Space After: $([Math]::Round($global:driveInfo.Free / 1GB,2) - $global:precheckTotal) GB"
                }
            })
        $numUsers++
        $yPos = $yPos + 30
        if (($numUsers % 9 -eq 0) -and ($numUsers -ne 0)) {
            $xPos = $xPos + 150
            $yPos = 0
        }
        $hash.sourceTab.Controls.Add($hash.userCB)
        Write-host "Added Checkbox for $($hash.userCB.Name)"
    }
    Get-PrecheckTotal
}

问题现象 #

函数运行时，控制台输出显示所有复选框已添加，但执行以下命令列出控件时：

foreach ($control in $hash.sourceTab.Controls) {
     Write-host $control
}

发现复选框不在控件列表中，也从未显示在窗体上。

排查与解决思路 #

1. 运行空间与UI线程的上下文冲突 #

WinForms控件必须在创建它的线程上操作，运行空间属于独立后台线程，直接在运行空间内操作UI控件会导致控件无法正确绑定到UI线程的控件集合。

• 修复：使用Control.Invoke()将控件添加操作委托到UI线程执行，替换原$hash.sourceTab.Controls.Add($hash.userCB)代码：

  $sourceTab = $hash.sourceTab
  $userCB = $hash.userCB
  $sourceTab.Invoke([Action]{
      $sourceTab.Controls.Add($userCB)
      Write-host "Added Checkbox for $($userCB.Name) on UI thread"
  })
  

2. 哈希表$hash的跨线程访问问题 #

$hash在主线程定义，运行空间中直接访问可能存在线程同步问题，导致引用的不是主线程的实际控件实例。

• 优化：将sourceTab作为参数传递给函数，而非依赖全局哈希表；或确保运行空间通过同步机制获取正确的控件引用。

3. 控件移除逻辑的错误 #

原代码通过TabIndex收集索引移除控件，但TabIndex会随控件增删动态变化，可能导致移除不彻底或误操作。

• 修复：直接遍历并移除复选框：

  $checkboxes = $hash.sourceTab.Controls | Where-Object { $_ -is [System.Windows.Forms.CheckBox] }
  foreach ($cb in $checkboxes) {
      $hash.sourceTab.Controls.Remove($cb)
      $cb.Dispose() # 释放控件资源
  }
  

4. 全局变量的跨线程可见性问题 #

运行空间的全局变量与主线程隔离，$global:UserFolders在运行空间赋值后无法被主线程直接访问，虽不是控件不显示的直接原因，但会引发后续逻辑异常。

• 优化：避免使用全局变量，改为函数返回结果后在UI线程处理控件创建。

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