Partilhar via


Como: telefonar um procedimento que tem parâmetros opcionais

Quando você chama um procedimento com um parâmetro opcional, você pode escolher se deseja fornecer o argumento correspondente.Caso contrário, o procedimento usa o valor padrão declarado para esse parâmetro.

  • Se você pretende fornecer o argumento, inclua-o na lista de argumentos de forma normal, entre vírgulas.

  • Se você pretende omitir o argumento, use vírgulas sucessivas na lista de argumentos para marcar sua omissão.

  • Se você omitir o argumento e estiver fornecendo argumentos pelo nome, você não precisará indicar o argumento omitido por nome ou por vírgulas.

Exemplo

O exemplo a seguir faz várias chamadas para o MsgBox função. MsgBox tem um necessário parâmetro e dois parâmetros opcionais.

MsgBox("Important message", MsgBoxStyle.Critical, "MsgBox Example")
MsgBox("Just display this message.")
MsgBox("Test message", , "Title bar text")
MsgBox(Title:="Title bar text", Prompt:="Test message")

A primeira chamada para MsgBox fornece todos os três argumentos na ordem MsgBox em que são definidos.A segunda chamada fornece apenas o argumento necessário.A terceira e quarta chamadas fornecem o primeiro e terceiro argumentos.A terceira chamada faz isso por posição, e a quarta chamada faz isso por nome.

Compilando o código

Antes de omitir um argumento de uma lista de argumentos, certifique-se de que o parâmetro correspondente seja opcional e certifique-se também que você deseja que o procedimento use o valor padrão para esse parâmetro.

Se você fornecer um argumento pelo nome, não deixe que o nome na lista de argumentos corresponda exatamente ao nome de parâmetro declarado.

Consulte também

Tarefas

Como: Definir parâmetros opcionais para um procedimento

Como: Determine se foi fornecido um parâmetro opcional

Conceitos

Parâmetros do procedimento e argumentos

Argumento Passing By valor e por referência

Passagem de Argumentos por Posição e Nome

Parâmetros Opcionais

Matrizes de parâmetro

Sobrecarga de procedimento

Referência

Opcional (Visual Basic)

ParamArray