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