Sobrecargas (Visual Basic)

Especifica que a propriedade ou procedimento declara novamente uma ou mais propriedades ou procedimentos existentes com o mesmo nome.

Comentários

Sobrecarregar é a prática de fornecer mais de uma definição para um mesmo nome de dada propriedade ou procedimento no mesmo escopo.Declarar novamente um propriedade ou procedimento com uma diferente assinatura é usualmente chamado de ocultamento por assinatura.

Regras

  • Contexto da Declaração. Você pode usar Overloads somente na declaração de uma propriedade ou procedimento.

  • Modificadores Combinados. Não é possível especificar Overloads em conjunto com Sombras (Visual Basic) na mesma declaração de procedimento.

  • Diferenças Requeridas. O assinatura nessa declaração deve ser diferente do que a assinatura de cada propriedade ou um procedimento que sobrecarrega.A assinatura consiste no nome da propriedade ou procedimento em conjunto com o seguinte:

    • o número de parâmetros

    • a ordem dos parâmetros

    • o tipo de dado dos parâmetros

    • o número de parâmetros do tipo (para um procedimento genérico)

    • o tipo de retorno (somente para um procedimento de operador de conversão)

    Todas as sobrecargas devem ter o mesmo nome, mas cada uma deve diferir de todas as outras em uma ou mais dentre as condições citadas.Isto permite ao compilador distinguir qual versão utilizar quando o código chama a propriedade ou procedimento.

  • Diferenças não Permitidas Modificar um ou mais dos itens abaixo não é válido para sobrecarga de propriedade ou procedimento, porque eles não fazem parte da assinatura:

    • o fato de retornar ou não um valor (para um procedimento)

    • o tipo de dado do valor de retorno (exceto para um operador de conversão)

    • os nomes dos parâmetros ou parâmetros do tipo

    • as restrições nos parâmetros do tipo (para um procedimento genérico)

    • palavras-chave modificadoras de parâmetros (como ByRef ou Optional)

    • palavras-chave modificadoras de propriedades ou procedimentos (como Public ou Shared)

  • Modificadores Opcionais. Você não precisará usar o Overloads modificador quando você está definindo várias propriedades sobrecarregadas ou procedimentos na mesma classe.Entretanto, se você usar Overloads em uma das declarações, você deve usar em todas elas.

  • **Sombreamento e Sobrecarga.**Overloads também pode ser usada para sombrear um membro existente, ou conjunto de membros sobrecarregados, em uma classe base.Quando você usa Overloads desse jeito, você declara a propriedade ou método com o mesmo nome e a mesma lista de parâmetros que o membro da classe base, e você não fornece a palavra-chave Shadows.

O modificador Overloads pode ser utilizado nestes contextos:

Instrução função

Instrução Operator

Propriedade declaração

Instrução Sub

Consulte também

Tarefas

Como: definir um operador de conversão (Visual Basic)

Referência

Sombras (Visual Basic)

Conceitos

Procedimento de sobrecarga (Visual Basic)

Tipos genéricos em Visual Basic (Visual Basic)

Procedimentos de operador (Visual Basic)