about_Ref

Aplica-se a: Windows PowerShell 2.0, Windows PowerShell 3.0

TÓPICO

about_Ref

DESCRIÇÃO BREVE

Descreve como criar e usar um tipo de variável de referência.

DESCRIÇÃO LONGA

Você pode usar o tipo de variável de referência para permitir que um método altere o valor de uma variável que é passado para ele.

Quando o tipo [ref] está associado a um objeto, ele retorna uma referência a esse objeto. Se a referência for usada com um método, o método poderá fazer referência ao objeto que foi passado para ele. Se o objeto for alterado no método, a alteração aparecerá como uma alteração no valor da variável quando o controle retorna para o método de chamada.

Para usar a referência, o parâmetro deve ser uma variável de referência. Se não, uma exceção InvalidArgument é lançada.

Os parâmetros usados na invocações do método devem corresponder ao tipo necessário pelos métodos.

Exemplos:

        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

A variável deve ser uma variável de referência.

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

CONSULTE TAMBÉM

about_Variables

about_Environment_Variables

about_Functions

about_Script_Blocks