Partilhar via

ByVal (Visual Basic)

  • Artigo

Especifica que um argumento é passado por valor, de modo que o procedimento ou propriedade chamada não pode alterar o valor de uma variável subjacente ao argumento no código de chamada. Se nenhum modificador for especificado, ByVal será o padrão.

Nota

Como é o padrão, não é necessário especificar explicitamente a palavra-chave nas assinaturas do ByVal método. Ele tende a produzir código barulhento e muitas vezes leva a palavra-chave não padrão ByRef sendo negligenciada.

Observações

O ByVal modificador pode ser usado nestes contextos:

Declaração de declaração

Instrução de função

Declaração do operador

Declaração do Imóvel

Subdeclaração

Exemplo

O exemplo a seguir demonstra o uso do mecanismo de passagem de parâmetros com um argumento de tipo de ByVal referência. No exemplo, o argumento é c1, uma instância de classe Class1. ByVal impede que o código nos procedimentos altere o valor subjacente do argumento de referência, c1mas não protege os campos acessíveis e as propriedades do c1.

Module Module1

    Sub Main()

        ' Declare an instance of the class and assign a value to its field.
        Dim c1 As New Class1()
        c1.Field = 5
        Console.WriteLine(c1.Field)
        ' Output: 5

        ' ByVal does not prevent changing the value of a field or property.
        ChangeFieldValue(c1)
        Console.WriteLine(c1.Field)
        ' Output: 500

        ' ByVal does prevent changing the value of c1 itself. 
        ChangeClassReference(c1)
        Console.WriteLine(c1.Field)
        ' Output: 500

        Console.ReadKey()
    End Sub

    Public Sub ChangeFieldValue(ByVal cls As Class1)
        cls.Field = 500
    End Sub

    Public Sub ChangeClassReference(ByVal cls As Class1)
        cls = New Class1()
        cls.Field = 1000
    End Sub

    Public Class Class1
        Public Field As Integer
    End Class

End Module

Consulte também