Procedura: cambiare il valore di un argomento di routine (Visual Basic)
Quando viene effettuata una chiamata a una routine, ciascun argomento specificato corrisponde a uno dei parametri definiti nella routine. In alcuni casi, il codice della routine può modificare il valore sottostante a un argomento nel codice chiamante. In altri, la routine può modificare solo la relativa copia locale di un argomento.
Quando si effettua una chiamata alla routine, in Visual Basic viene creata una copia locale di ogni argomento passato ByVal (Visual Basic). Per ciascun argomento passato ByRef (Visual Basic), Visual Basic assegna al codice della routine un riferimento diretto all'elemento di programmazione sottostante all'argomento nel codice chiamante.
Se tale elemento sottostante è modificabile e l'argomento viene passato ByRef, il codice della routine può utilizzare il riferimento diretto per modificare il valore dell'elemento nel codice chiamante.
Modifica del valore sottostante
Per modificare il valore sottostante di un argomento di routine nel codice chiamante
Nella dichiarazione della routine specificare ByRef (Visual Basic) per il parametro che corrisponde all'argomento.
Nel codice chiamante passare un elemento di programmazione modificabile come argomento.
Nel codice chiamante non racchiudere l'argomento tra parentesi nell'elenco degli argomenti.
Nel codice della routine utilizzare il nome del parametro per assegnare un valore all'elemento sottostante nel codice chiamante.
Per una dimostrazione, vedere l'esempio riportato di seguito.
Modifica delle copie locali
Se l'elemento sottostante nel codice chiamante non è modificabile o se l'argomento viene passato ByVal, la routine non può modificare il relativo valore nel codice chiamante. Può invece modificare la relativa copia locale di questo tipo di argomento.
Per modificare la copia di un argomento di routine nel codice della routine
Nella dichiarazione della routine specificare ByVal (Visual Basic) per il parametro che corrisponde all'argomento.
-oppure-
Nel codice chiamante racchiudere l'argomento tra parentesi nell'elenco degli argomenti. In questo modo, Visual Basic verrà forzato a passare l'argomento per valore, anche se nel parametro corrispondente è specificato ByRef.
Nel codice della routine utilizzare il nome del parametro per assegnare un valore alla copia locale dell'argomento. Il valore sottostante nel codice chiamante non verrà modificato.
Esempio
Nell'esempio riportato di seguito vengono illustrate due routine che accettano una variabile di matrice e operano sui relativi elementi. La routine increase aggiunge semplicemente uno a ogni elemento. La routine replace assegna una nuova matrice al parametro a(), quindi aggiunge uno a ogni elemento.
Public Sub increase(ByVal a() As Long)
For j As Integer = 0 To UBound(a)
a(j) = a(j) + 1
Next j
End Sub
Public Sub replace(ByRef a() As Long)
Dim k() As Long = {100, 200, 300}
a = k
For j As Integer = 0 To UBound(a)
a(j) = a(j) + 1
Next j
End Sub
Dim n() As Long = {10, 20, 30, 40}
Call increase(n)
MsgBox("After increase(n): " & CStr(n(0)) & ", " &
CStr(n(1)) & ", " & CStr(n(2)) & ", " & CStr(n(3)))
Call replace(n)
MsgBox("After replace(n): " & CStr(n(0)) & ", " &
CStr(n(1)) & ", " & CStr(n(2)) & ", " & CStr(n(3)))
Alla prima chiamata MsgBox viene visualizzato il seguente messaggio: "After increase(n): 11, 21, 31, 41". Poiché la matrice n è un tipo di riferimento, la routine replace può modificarne i membri, anche se il meccanismo di passaggio è ByVal.
Alla seconda chiamata MsgBox viene visualizzato il seguente messaggio: "After replace(n): 101, 201, 301". Poiché n viene passato ByRef, la routine replace può modificare la variabile n nel codice chiamante e assegnare a quest'ultima una nuova matrice. Poiché n è un tipo di riferimento, la routine replace può anche modificarne i membri.
È possibile impedire alla routine di modificare la variabile nel codice chiamante. Per informazioni, vedere Procedura: impedire la modifica del valore di un argomento di una routine (Visual Basic).
Compilazione del codice
Quando si passa una variabile per riferimento, è necessario utilizzare la parola chiave ByRef per specificare tale meccanismo.
Per impostazione predefinita, in Visual Basic gli argomenti vengono passati per valore. Durante le attività di programmazione si consiglia comunque di includere la parola chiave ByVal (Visual Basic) o ByRef (Visual Basic) con ogni parametro dichiarato al fine di agevolare la lettura del codice.
Sicurezza
Consentire a una routine di modificare il valore sottostante a un argomento nel codice chiamante è sempre potenzialmente rischioso. Accertarsi che la modifica del valore sia prevista e verificare la validità del valore prima di utilizzarlo.
Vedere anche
Attività
Procedura: passare argomenti a una routine (Visual Basic)
Procedura: impedire la modifica del valore di un argomento di una routine (Visual Basic)
Procedura: forzare il passaggio di un argomento per valore (Visual Basic)
Concetti
Parametri e argomenti delle routine (Visual Basic)
Passaggio di argomenti per valore e per riferimento (Visual Basic)
Differenze tra argomenti modificabili e non modificabili (Visual Basic)
Differenze tra il passaggio di un argomento per valore e per riferimento (Visual Basic)
Passaggio di argomenti in base alla posizione e al nome (Visual Basic)