about_Ref

適用於: Windows PowerShell 2.0, Windows PowerShell 3.0, Windows PowerShell 4.0, Windows PowerShell 5.0

主題

about_Ref

簡短描述

說明如何建立及使用參考變數類型。

詳細描述

您可以使用參考變數類型來允許方法針對傳遞至其的變數值進行變更。

當 [ref] 類型與物件相關聯時，其會傳回該物件的參考。如果參考與方法搭配使用，則此方法可以參考已經傳遞給其的物件。如果物件已在方法內變更，則當控制項傳回至呼叫方法時，該變更會顯示為變數之值的變更。

若要使用參考，則參數必須是參考變數。如果不是，則會擲回 InvalidArgument 例外狀況。

在方法引動過程中所使用的參數必須符合方法所需的類型。

範例：

        PS> function swap([ref]$a,[ref]$b) 
        >> { 
        >>     $a.value,$b.value = $b.value,$a.value 
        >> }

        PS> $a = 1
        PS> $b = 10
        PS> $a,$b
        1
        10
        PS> swap ([ref]$a) ([ref]$b)
        PS> $a,$b
        10
        1

        PS C:\ps-test> function double
        >> {
        >>     param ([ref]$x) $x.value = $x.value * 2
        >> }

        PS C:> $number = 8
        PS C:> $number
        8
        PS C> double ([ref]$number)
        PS C> $number
        16

變數必須是參考變數。

        PS C:\ps-test> double $number
        double : Reference type is expected in argument.
        At line:1 char:7
        + double  <<<< $number

另請參閱

about_Variables

about_Environment_Variables

about_Functions

about_Script_Blocks