Compartilhar via


Como: Chamar um procedimento que recebe parâmetros opcionais (Visual Basic)

When you call a procedure with an optional parameter, you can choose whether to supply the corresponding argument. If you do not, the procedure uses the default value declared for that parameter.

  • If you intend to supply the argument, include it in the argument list in the normal way, between commas.

  • If you intend to omit the argument, use successive commas in the argument list to mark its omission.

  • If you omit the argument and you are supplying arguments by name, you do not need to indicate the omitted argument either by name or by commas.

Exemplo

O exemplo a seguir faz várias chamadas para o MsgBoxdefunção. MsgBoxum exigiu o 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")

The first call to MsgBox supplies all three arguments in the order MsgBox defines them. The second call supplies only the required argument. The third and fourth calls supply the first and third arguments. The third call does this by position, and the fourth call does it by name.

Compilando o código

Before you omit an argument from the argument list, be sure the corresponding parameter is optional, and also be sure you want the procedure to use the default value for that parameter.

If you supply an argument by name, be sure the name in the argument list exactly matches the declared parameter name.

Consulte também

Tarefas

Como: Definir parâmetros opcionais para um procedimento (Visual Basic)

Como: Determinar se um parâmetro opcional foi fornecido (Visual Basic)

Referência

Opcional (Visual Basic)

ParamArray (Visual Basic)

Conceitos

Parâmetros e argumentos de procedimento (Visual Basic)

Passando argumentos por valor e por referência (Visual Basic)

Passagem de argumentos por posição e nome (Visual Basic)

Parâmetros opcionais (Visual Basic)

Matrizes de parâmetros (Visual Basic)

Sobrecarga de procedimento (Visual Basic)