Como passar argumentos para um procedimento (Visual Basic)How to: Pass Arguments to a Procedure (Visual Basic)

Ao chamar um procedimento, você segue o nome do procedimento com uma lista de argumentos entre parênteses.When you call a procedure, you follow the procedure name with an argument list in parentheses. Você fornece um argumento correspondente a cada parâmetro necessário que o procedimento define e, opcionalmente, pode fornecer argumentos para os Optional parâmetros.You supply an argument corresponding to every required parameter the procedure defines, and you can optionally supply arguments to the Optional parameters. Se você não fornecer um Optional parâmetro na chamada, deverá incluir uma vírgula para marcar seu lugar na lista de argumentos, se você estiver fornecendo argumentos subsequentes.If you do not supply an Optional parameter in the call, you must include a comma to mark its place in the argument list if you are supplying any subsequent arguments.

Se você pretende passar um argumento de um tipo de dados diferente daquele de seu parâmetro correspondente, como Byte para String , você pode definir a opção de verificação de tipo (instrução Option Strict) para Off .If you intend to pass an argument of a data type different from that of its corresponding parameter, such as Byte to String, you can set the type-checking switch (Option Strict Statement) to Off. Se Option Strict for On , você deve usar conversões de alargamento ou palavras-chave de conversão explícita.If Option Strict is On, you must use either widening conversions or explicit conversion keywords. Para obter mais informações, consulte conversões de ampliação e estreitamento e funções de conversão de tipo.For more information, see Widening and Narrowing Conversions and Type Conversion Functions.

Para obter mais informações, consulte parâmetros e argumentos de procedimento.For more information, see Procedure Parameters and Arguments.

Para passar um ou mais argumentos para um procedimentoTo pass one or more arguments to a procedure

  1. Na instrução de chamada, siga o nome do procedimento com parênteses.In the calling statement, follow the procedure name with parentheses.

  2. Dentro dos parênteses, coloque uma lista de argumentos.Inside the parentheses, put an argument list. Inclua um argumento para cada parâmetro necessário que o procedimento define e separe os argumentos com vírgulas.Include an argument for each required parameter the procedure defines, and separate the arguments with commas.

  3. Certifique-se de que cada argumento é uma expressão válida que é avaliada como um tipo de dados conversível para o tipo que o procedimento define para o parâmetro correspondente.Make sure each argument is a valid expression that evaluates to a data type convertible to the type the procedure defines for the corresponding parameter.

  4. Se um parâmetro for definido como opcional, você poderá incluí-lo na lista de argumentos ou omiti-lo.If a parameter is defined as Optional, you can either include it in the argument list or omit it. Se você omiti-lo, o procedimento usará o valor padrão definido para esse parâmetro.If you omit it, the procedure uses the default value defined for that parameter.

  5. Se você omitir um argumento para um Optional parâmetro e houver outro parâmetro depois dele na lista de parâmetros, você poderá marcar o lugar do argumento omitido por uma vírgula extra na lista de argumentos.If you omit an argument for an Optional parameter and there is another parameter after it in the parameter list, you can mark the place of the omitted argument by an extra comma in the argument list.

    O exemplo a seguir chama a MsgBox função Visual Basic.The following example calls the Visual Basic MsgBox function.

    Dim mbResult As MsgBoxResult
    Dim displayString As String = "Show this string to the user"
    mbResult = MsgBox(displayString, , "Put this in the title bar")
    

    O exemplo anterior fornece o primeiro argumento necessário, que é a cadeia de caracteres da mensagem a ser exibida.The preceding example supplies the required first argument, which is the message string to be displayed. Ele omite um argumento para o segundo parâmetro opcional, que especifica os botões a serem exibidos na caixa de mensagem.It omits an argument for the optional second parameter, which specifies the buttons to be displayed on the message box. Como a chamada não fornece um valor, MsgBox o usa o valor padrão, MsgBoxStyle.OKOnly , que exibe apenas um botão OK .Because the call does not supply a value, MsgBox uses the default value, MsgBoxStyle.OKOnly, which displays only an OK button.

    A segunda vírgula na lista de argumentos marca o lugar do segundo argumento omitido e a última cadeia de caracteres é passada para o terceiro parâmetro opcional de MsgBox , que é o texto a ser exibido na barra de título.The second comma in the argument list marks the place of the omitted second argument, and the last string is passed to the optional third parameter of MsgBox, which is the text to be displayed in the title bar.

Consulte tambémSee also