PowerShell 类方法的引用参数？ [参考][Uint64]

我有一个 powershell 类，我需要传递对 UInt64 变量的引用并从方法返回一个值。我正在尝试执行类似于下面代码的操作，但它给了我一个语法错误。

也许我不需要添加？[参考]？因为所有变量在 powershell 中默认都是引用，包括 uint64？但我只是不确定这是否属实......如果我遵循正常的 C 语言约定，那么该方法将获取参数的副本，而不是对变量的实际引用。我似乎记得 C# 中有关装箱和拆箱 int 类型的内容......C# int 类型的装箱和拆箱 https://learn.microsoft.com/en-us/dotnet/csharp/programming-guide/types/boxing-and-unboxingPowershell 类方法的装箱 Int 是如何工作的？

class PowerHe11 {

    # Constructor
    PowerHe11() {
    }

    [void]AccessChannel(
        [UInt64]$ichan,
        [UInt64]$idata,
        [UInt64]$isize,
        [UInt64]$ireal,    
        [ref][UInt64]$otimeout,
        [ref][UInt64]$odata,
        [ref][UInt64]$ochan,
        [ref][UInt64]$osize

    ) {                  
        $osize = 64;  #Return this value to caller of method
    }
}

错误信息是：

At C:\Users\wmoore\Documents\fpga\zynq_pl\run_ps1\Untitled1.ps1:13 char:11
+         [ref][UInt64]$otimeout,
+              ~~~~~~~~
Multiple type constraints are not allowed on a method parameter.
At C:\Users\wmoore\Documents\fpga\zynq_pl\run_ps1\Untitled1.ps1:14 char:14
+         [ref][UInt64]$odata,
+              ~~~~~~~~
Multiple type constraints are not allowed on a method parameter.
At C:\Users\wmoore\Documents\fpga\zynq_pl\run_ps1\Untitled1.ps1:15 char:14
+         [ref][UInt64]$ochan,
+              ~~~~~~~~
Multiple type constraints are not allowed on a method parameter.
At C:\Users\wmoore\Documents\fpga\zynq_pl\run_ps1\Untitled1.ps1:16 char:14
+         [ref][UInt64]$osize
+              ~~~~~~~~
Multiple type constraints are not allowed on a method parameter.
    + CategoryInfo          : ParserError: (:) [], ParentContainsErrorRecordException
    + FullyQualifiedErrorId : MultipleTypeConstraintsOnMethodParam

你自己的答案 https://stackoverflow.com/a/65130083/45375显示解决方案；让我添加解释和背景信息：

about_Ref https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_Ref是官方帮助主题。

它的缺点是：

• [ref]的主要目的是支持ref and out参数在.NET 方法;例如，调用System.Int32.TryParse https://learn.microsoft.com/en-US/dotnet/api/System.Int32.TryParse方法，使用以下内容：

  • [int] $int = 0; [int]::TryParse('42', [ref] $int)

  • 请注意，变量的类型必须与 .NET 方法期望的类型匹配，并且在 PowerShell 中创建变量的唯一方法是为其分配一个值（即使该值是不相关的，就像使用out手头的参数）；这[ref]需要强制转换（类似于需要使用ref or out in C#.

  • 你可能会通过[ref] $null如果您对该方法分配的值不感兴趣。

• 当你can在 PowerShell 代码中使用它，这样做是awkward，如您的示例所示：

  • 接收的 PowerShell 代码[ref]参数必须通过.Value财产，正如你的答案所示。

  • You 不能进行类型约束这样一个参数，所以你失去了类型安全。

    • 请注意，在函数和脚本- 与定制类相反methods- 这是语法上允许，但毫无意义两者都使用[ref]和目标数据类型（例如[ref][UInt64]$otimeout在你的例子中），因为后者实际上是ignored; e.g.:

      • function foo { param([ref] [int] $p) $p.Value += '!' }; $bar = 'none'; foo ([ref] $bar); $bar

      • 调用成功并且$bar包含'none!'，这意味着[int]类型约束被忽略。

  • 调用脚本和函数需要参数模式语法 https://stackoverflow.com/a/48779223/45375（类似 shell、空格分隔的参数、允许裸字字符串），使得[ref]-cast 调用通过 require 变得更加尴尬(...)围绕参数，如上所示（foo ([ref] $bar)).

  • 关于在自定义 PowerShell 中使用class是的，请注意PowerShell 的类支持 https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_Classes是 - 按设计 -not与面向对象的语言相当，例如C#;也就是说，已计划进行增强；不幸的是，从 PowerShell 7.1 开始，即使有限的功能集仍然存在问题 - 请参阅GitHub 问题 #6652 https://github.com/PowerShell/PowerShell/issues/6652.

技术背景[ref]:

[ref]，不像ref在 C# 中，是not语言关键字: it is a type，即[System.Management.Automation.PSReference] https://learn.microsoft.com/en-US/dotnet/api/System.Management.Automation.PSReference (whose 类型加速器 https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_Type_Accelerators is [ref]).

因此，诸如此类的表达式[ref] $var is a cast那隐含地构造一个[ref]实例，需要绑定到[ref]- 类型参数。

Caveats:

• There is parser magic involved in a [ref] cast, because you cannot directly use the normally equivalent [ref]::new($var) constructor expression as an alternative to cast [ref] $var.
  • PowerShell 需要魔法才能知道这一点$var指的是变量对象本身而不是变量的value，就像表达式中通常的情况一样 - 后者确实是发生的情况[ref]::new($var) - $var's value被包裹在一个[ref]实例。
  • 真正的构造函数相当于[ref] $var is [ref]::new((Get-Variable var))

# BROKEN: Do not use a constructor - [ref]::new($int) - 
#         in lieu of a cast - [ref] $int
PS> [int] $int = 0; $null = [int]::TryParse('42', [ref]::new($int)); $int
0 # !! $int was NOT updated, because its *value* was wrapped in a [ref] instance

• 通常只有使用[ref]演员与变量（对象） operand.

  • PowerShell 允许您传递任何值作为操作数，这在技术上是可行的，但除非您显式保存，否则没有任何意义the [ref]实例在变量中，传递it作为参数，然后使用[ref]实例的.Value属性来访问更新的值：

# Save a [ref] instance in a variable, pass it, then use .Value to get the 
# updated value.
PS> [ref] $intRef = 0; $null = [int]::TryParse('42', $intRef); $intRef.Value
42