Sub-rotina demonstrativo (Visual Basic)

Declara o nome, parâmetros e código que definem um procedimento Sub.

[ <attributelist> ] [ Partial ] [ accessmodifier ] [ proceduremodifiers ] [ Shared ] [ Shadows ] 
Sub name [ (Of typeparamlist) ] [ (parameterlist) ] [ Implements implementslist | Handles eventlist ]
    [ statements ]
    [ Exit Sub ]
    [ statements ]
End Sub

Partes

• attributelist
  Opcional.Veja Lista de Atributos.

• Partial
  Opcional.Indica a definição de um método parcial.SeeMétodos parciais.

• accessmodifier
  Opcional.Pode ser um dos seguintes:

  • Público

  • Protegido

  • Friend

  • Private

  • Protected Friend

  SeeNíveis de acesso em Visual Basic.

• proceduremodifiers
  Opcional.Pode ser um dos seguintes:

  • Sobrecargas

  • Substitui

  • Overridable

  • NotOverridable

  • MustOverride

  • MustOverride Overrides

  • NotOverridable Overrides

• Shared
  Opcional.Consulte Compartilhada.

• Shadows
  Opcional.Acesse Shadows.

• name
  Obrigatório.Nome do procedimento.SeeNomes de Elementos Declarados.

• typeparamlist
  Opcional.Lista de parâmetros de tipo para um procedimento genérico.Consulte Type List.

• parameterlist
  Opcional.Lista de nomes variável local que representam os parâmetros deste procedimento.SeeLista de parâmetros.

• Implements
  Opcional.Indica que essa propriedade implementa uma ou mais procedimentos Sub, cada uma delas definida em uma interface implementada por essa classe ou estrutura contendo o procedimento.SeeImplementa Declaração.

• implementslist
  Necessário se Implements é fornecido.Lista de procedimentos Sub que serão implementados

  implementedprocedure [ , implementedprocedure ... ]

  Cada implementedprocedure possui a seguinte sintaxe e partes:

  interface.definedname

  Parte	Descrição
  interface	Obrigatório.Nome de uma interface implementada por essa classe ou estrutura contendo o procedimento.
  definedname	Obrigatório.Nome pelo qual o procedimento é definido em interface.

• Handles
  Opcional.Indica que esse procedimento pode manipular um ou mais eventos específicos.SeeTrata.

• eventlist
  Necessário se Handles é fornecido.Lista de eventos que esse procedimento manipula.

  eventspecifier [ , eventspecifier ... ]

  Cada eventspecifier possui a seguinte sintaxe e partes:

  eventvariable.event

  Parte	Descrição
  eventvariable	Obrigatório.Variável de objeto declarada com o tipo de dados da classe ou estrutura que gera o evento.
  event	Obrigatório.Nome do evento que esse procedimento manipula.

• statements
  Opcional.Bloco de instruções para executar este procedimento dentro do.

• EndSub
  Finaliza a definição desse procedimento.

Comentários

Todos os códigos executáveis deverão estar dentro de um procedimento.Use um Sub Quando não é necessário retornar um valor para o código de chamada de procedimento. Use um Function procedimento quando precisar retornar um valor.

Você pode usar Sub somente no nível de módulo. Isso significa que o declaração de contexto para obter um procedimento sub deve ser uma classe, estrutura, módulo ou interface e não pode ser um arquivo de fonte, namespace, procedimento ou bloco.Para obter mais informações, consulte Declaração de contextos e níveis de acesso padrão.

Procedimentos Sub têm acesso público como padrão.Você pode ajustar os níveis de acesso com os modificadores de acesso.

Regras

• Implementação Se este procedimento usa o Implements palavra-chave, o recipiente classe ou estrutura deve ter um Implements demonstrativo imediatamente seguinte a Class ou Structure demonstrativo. A instrução Implements deve incluir cada interface especificada em implementslist.No entanto, o nome pelo qual uma interface define a Sub (em definedname) não precisa ser o mesmo que o nome do procedimento (em name).

Comportamento

• Retornando a partir de um Procedimento. Quando o procedimento Sub retorna para o código de chamada, a execução continua com a instrução após a instrução que o chamou.

  O Exit Sub e instruções Return causam saída imediata de um procedimento Sub.Qualquer número de declarações Exit Sub e Return pode aparecer em qualquer lugar no procedimento, e você pode misturar declarações Exit Sub e Return.

  O exemplo a seguir mostra um retorno de um Sub procedimento.

  Sub mySub(ByVal q As String)
      Return
  End Sub 
  

• Chamando um procedimento. A Sub procedimento, como um Function procedimento, é um procedimento separado que pode receber parâmetros e executar uma série de instruções. No entanto, ao contrário de um Function procedimento, que retorna um valor, um Sub procedimento não pode ser usado em uma expressão.

  You telefonar a Sub procedimento usando o nome do procedimento, seguido de lista de argumentos entre parênteses, em uma demonstrativo. Você pode omitir parênteses somente se você não está fornecendo quaisquer argumentos.No entanto, seu código é mais legível se você sempre incluir os parênteses.

  Opcionalmente, você pode usar o Call demonstrativo para telefonar um Sub procedimento. Isso pode melhorar a legibilidade do código.

Solução de problemas

Ordem de Execução. Visual Basic, às vezes, reorganiza expressões aritméticas para aumentar a eficiência interna.Por esse motivo, se sua lista de argumentos contém expressões que telefonar outros procedimentos não se pode confiar neles sendo telefonar ed em uma ordem específica.

Exemplo

O exemplo a seguir utiliza o Sub demonstrativo para definir o nome, parâmetros e o código que formulário o corpo de um Sub procedimento.

Sub computeArea(ByVal length As Double, ByVal width As Double)
    ' Declare local variable.
    Dim area As Double
    If length = 0 Or width = 0 Then
        ' If either argument = 0 then exit Sub immediately.
        Exit Sub
    End If
    ' Calculate area of rectangle.
    area = length * width
    ' Print area to Immediate window.
    Debug.WriteLine(area)
End Sub

Consulte também

Tarefas

Como: Usar uma classe genérica

Solucionando problemas de procedimentos

Como: Criar um método parcial (Visual Basic)

Conceitos

Matrizes de parâmetro

Métodos parciais

Referência

Implementa Declaração

Instrução Function (Visual Basic)

Lista de parâmetros

Instrução Dim (Visual Basic)

Chamar demonstrativo (Visual Basic)

Of