Lista de parâmetros (Visual Basic)
Especifica os parâmetros do procedimento quando é chamado. Múltiplos parâmetros são separados por vírgulas. O seguinte trecho é a sintaxe para um parâmetro.
[ <attributelist> ] [ Optional ] [{ ByVal | ByRef }] [ ParamArray ]
parametername[( )] [ As parametertype ] [ = defaultvalue ]
Partes
attributelist
Opcional. Lista de atributos que se aplicam a esse parâmetro. Você delimitar a Lista de atributos (Visual Basic) entre colchetes ("<" e ">").Optional
Opcional. Especifica que este parâmetro não é necessário quando o procedimento é chamado.ByVal
Opcional. Especifica que o procedimento não pode substituir or reatribuir o elemento variável dando suporte ao argumento correspondente num código de chamada.ByRef
Opcional. Especifica que o procedimento pode modificar o elemento variável oculto no código de chamada da mesma maneira que o código de chamada em si pode.ParamArray
Opcional. Especifica que o último parâmetro na lista de parâmetros é um array opcional de elementos do tipo de dados especificados. Isso permite que o código de chamada passe um número arbitrário de argumentos ao procedimento.parametername
Obrigatório. Nome da variável local representando o parâmetro.parametertype
Necessário se Option Strict estiver On. Tipo de dados da variável local representando o parâmetro.defaultvalue
Necessário para parâmetros Optional. Qualquer constante ou expressão constante que avalia o tipo de dados do parâmetro. Se o tipo é Object, ou uma classe, interface, array, ou estrutura, o valor padrão pode ser apenas Nothing.
Comentários
Parâmetros são rodeados por parênteses e separados por vírgulas. Um parâmetro pode ser declarado com qualquer tipo de dados. Se você não especificar parametertype, o padrão é Object.
Quando o código de chamada chama o procedimento, ele passa um argumento para cada parâmetro requisitado. Para obter mais informações, consulte Diferenças entre parâmetros e argumentos (Visual Basic).
O argumento que o código de chamada passa para cada parâmetro é um ponteiro para um elemento oculto no código de chamada. Se este elemento éinvariável (uma constante, literal, enumeração, ou expressão), é impossível para qualquer código mudá-lo. Se é um elemento variável (uma variável declarada, campo, propriedade, elemento de array, ou elemento de estrutura), o código de chamada pode mudá-lo. Para obter mais informações, consulte Diferenças entre argumentos modificáveis e não modificáveis (Visual Basic).
Se um elemento variável é passado ByRef, o procedimento pode mudá-lo da mesma maneira. Para obter mais informações, consulte Diferenças entre passar um argumento por valor e por referência (Visual Basic).
Regras
Entre parênteses. Se você especificar uma lista de parâmetro, você deve delimitá-la entre parênteses. Se não há parâmetros, você ainda pode usar parênteses delimitando uma lista vazia. Isto melhora a legibilidade se seu código deixando mais claro que o elemento é um procedimento.
Parâmetros opcionais. Se você usar o Optional modificador em um parâmetro, todos os parâmetros subseqüentes na lista também deve ser opcionais e ser declarados usando a Optional modificador.
Toda declaração de parâmetro opcional deve fornecer a cláusula defaultvalue.
Para obter mais informações, consulte Parâmetros opcionais (Visual Basic).
Arrays de parâmetro. Você deve especificar ByVal para um ParamArray parâmetro.
Você não pode usar ambos Optional e ParamArray na mesma lista de parâmetros.
Para obter mais informações, consulte Matrizes de parâmetros (Visual Basic).
Mecanismo de Passagem. O mecanismo padrão para cada argumento é ByVal, que significa que o procedimento não é possível alterar o elemento variável subjacente. Entretanto, se o elemento é um tipo de referência, o procedimento pode modificar os conteúdos ou membros do objeto oculto, mesmo se ele mesmo não pode substituir ou reatribuir o objeto.
Nomes de parâmetro. Se o tipo de dados do parâmetro for uma matriz, execute parametername imediatamente por parênteses. Para mais informações sobre nomes de parâmetros, consulte Nomes de elemento declarados (Visual Basic).
Exemplo
O seguinte exemplo mostra um procedimento Function que define dois parâmetros.
Public Function howMany(ByVal ch As Char, ByVal st As String) As Integer
End Function
Dim howManyA As Integer = howMany("a"c, "How many a's in this string?")
Consulte também
Tarefas
Como quebrar e combinar instruções no código (Visual Basic)