Procedimentos Sub (Visual Basic)

Um Subprocedimento é uma série deVisual Basic declarações anexado pelo Sube por End Subdeclarações.O Sub procedimento realiza uma tarefa e então retorna controle ao código de chamada, mas não retorna um valor ao código de chamada.

Cada vez que é feita uma chamada de procedimento, suas declarações são executadas, começando pela primeira declaração executável depois da Sub declaração e finalizando com o primeiro End Sub,Exit Sub, ou declaraçãoReturn encontrada.

Você pode definir um Subprocedimento em módulos, classes e estruturas.Por padrão, é Public, o que significa que você pode chamá-lo de qualquer lugar no seu aplicativo que acessou o módulo, classe ou estrutura na qual você a definiu.O termo método descreve um procedimentoSub ou Function que é acessado de fora de seu módulo definidor, classe ou estrutura.Para obter mais informações, consulte Procedimentos no Visual Basic.

Um procedimento Sub pode receber argumentos, como constantes, variáveis ou expressões, que são passadas a ele pelo código de chamada.

Sintaxe da Declaração

A sintaxe para declarar um Sub procedimento é como se segue:

[modifiers] Sub subname[(parameterlist)]

' Statements of the Sub procedure.

End Sub

O modifiers podem especificar o nível de acesso e informações sobre sobrecarregamento, desautorizações, compartilhamento e sombreamento.Para obter mais informações, consulte Instrução Sub (Visual Basic).

Declaração de parâmetros

Você declara cada parâmetro de procedimento similarmente a como você declara uma variável, especificando o nome do parâmetro e o tipo dos dados.Você pode, também, especificar o mecanismo de passagem, e se o parâmetro é opcional ou uma matriz de parâmetros.

A sintaxe para cada parâmetro na lista de parâmetros é como se segue:

[Optional] [ByVal | ByRef] [ParamArray] ParameterName As tipo de dados

Se o parâmetro é opcional, você deve também fornecer um valor padrão como parte de sua declaração.A sintaxe para especificar um valor padrão é como se segue:

Optional [ByVal | ByRef] ParameterName As tipo de dados = defaultvalue

Parâmetros como variáveis locais

Quando o controle passa para o procedimento, cada parâmetro é tratado como uma variável local.Isso significa que seu tempo de vida é o mesmo que o do procedimento, e seu escopo é o procedimento inteiro.

Sintaxe de Chamada

Você invocar um Sub procedimento explicitamente com uma declaração de chamada que permanece sozinha.Você não pode chamá-lo usando seu nome numa expressão.Você deve fornecer valores para todos os argumentos que não são opcionais, e você precisa cercar a lista de argumentos entre parênteses.Se nenhum argumento é fornecido, você pode, opcionalmente, omitir os parênteses.O uso do Call teclado é opcional, mas não é recomendado.

A sintaxe para chamar um procedimento Sub é o seguinte:

[Call] subname[(Listadeargumentos)]

Você pode chamar um método Sub de fora da classe que a define.Primeiramente, você tem de usar o teclado New para criar um exemplo da classe, ou chamar um método que retorna um exemplo da classe.Para obter mais informações, consulte Operador New (Visual Basic).Então, você pode usar a seguinte sintaxe para chamar o método Sub no objeto de exemplo.

Objeto,nome do método[(lista de argumentos)]

Ilustração de Declaração e Chamada

O seguinte procedimento Sub manda o operador do computador qual tarefa de aplicativo está prestes a executar, e também exibe um carimbo de data/hora.Em vez de duplicar este código no início de toda tarefa, o aplicativo apenas chama tellOperator de várias localizações.Cada chamada passa uma string no argumento do task que identifica que a tarefa está sendo iniciada.

Sub tellOperator(ByVal task As String)
    Dim stamp As Date
    stamp = TimeOfDay()
    MsgBox("Starting " & task & " at " & CStr(stamp))
End Sub

O exemplo a seguir mostra uma chamada típica a tellOperator.

tellOperator("file update")

Consulte também

Tarefas

Como: chamar um procedimento que não retorna um valor (Visual Basic)

Como: chamar um manipulador de eventos em Visual Basic

Referência

Instrução Sub (Visual Basic)

Conceitos

Procedimentos no Visual Basic

Procedimentos Function (Visual Basic)

Procedimentos de propriedade (Visual Basic)

Procedimentos de operador (Visual Basic)

Parâmetros de procedimentos e argumentos (Visual Basic)