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 os 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 os argumentos podem ser modificadas e Nonmodifiable (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 pelo 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 elementos 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)