about_Ref

主題
    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 : 引數中必須是參考型別。
        位於第 1 行，第 7 個字元
        + double <<<< $number
    
 
請參閱
    about_Variables
    about_Environment_Variables
    about_Functions
    about_Script_Blocks