Sobrecarga de procedimento (Visual Basic)
Sobrecarga um procedimento significa que a definição em várias versões, usando o mesmo nome mas diferentes parâmetro listas. The purpose of overloading is to define several closely related versions of a procedure without having to differentiate them by name. Para fazer isso variando a lista de parâmetro .
Regras de sobrecarga.
Quando você sobrecarga um procedimento, as seguintes regras aplicar:
O mesmo Nome. Cada versão de sobrecarregada deve usar o mesmo nome do procedimento .
Assinatura diferente. Cada versão de sobrecarregada deve diferir de todas as outras versões sobrecarregadas em pelo menos um dos seguintes aspectos:
Número de parâmetros
Ordem dos parâmetros
Tipos de dados dos parâmetros
Número de parâmetros de tipo (para um procedimentogenérico)
Retornar o tipo (somente para uma conversão de operador)
Junto com o nome do procedimento , os itens anteriores são coletivamente chamados de assinatura do procedimento. Quando você chamar um procedimentode sobrecarregado, o compilador usa a assinatura para verificar se a chamada corretamente coincide com a definição.
Itens não faz parte da assinatura. Você não pode sobrecarga um procedimento sem a assinaturade variação. Em particular, você não pode sobrecarga um procedimento , variando apenas um ou mais dos seguintes itens:
Procedure modifier keywords, such as Public, Shared, and Static
Nomes de parâmetro de tipo ou o parâmetro
Tiporestrições deparâmetro (para um procedimentogenérico)
Parameter modifier keywords, such as ByRef and Optional
Se ele retorna um valor
The data type of the return value (except for a conversion operator)
Os itens da lista anterior não são parte da assinatura. Embora você não pode usá-los para diferenciar entre versões sobrecarregadas, você pode variá-los entre versões sobrecarregadas, corretamente são diferenciadas por suas assinaturas.
Atrasado-argumentos acoplados. Se você pretende passar uma tarde limite objeto variável para uma versãode sobrecarregada, você deve declarar o parâmetro apropriado como Object.
Várias versões de um procedimento
Suponha que você está escrevendo um Suboprocedimento para lançar uma transação contra o saldo de um clientee você deseja ser capaz de se referir ao cliente pelo nome ou pelo número de conta. Para acomodar isso, você pode definir duas diferentes Sub procedimentos, como no exemplo a seguir:
Sub postName(ByVal custName As String, ByVal amount As Single)
' Insert code to access customer record by customer name.
End Sub
Sub postAcct(ByVal custAcct As Integer, ByVal amount As Single)
' Insert code to access customer record by account number.
End Sub
Versões sobrecarregadas
Uma alternativa é sobrecarga um nome único procedimento . Você pode usar o Sobrecargas (Visual Basic) palavra-chave para definir uma versão do procedimento para cada lista de parâmetro , como segue:
Overloads Sub post(ByVal custName As String, ByVal amount As Single)
' Insert code to access customer record by customer name.
End Sub
Overloads Sub post(ByVal custAcct As Integer, ByVal amount As Single)
' Insert code to access customer record by account number.
End Sub
Sobrecargas adicionais
Se quiser aceitar o valor de uma transação em um Decimal ou Single, poderia ser mais sobrecarga post para permitir esta variação. Se você já fez isso para cada uma das sobrecargas no exemplo anterior, você teria quatro Sub procedimentos, todos com o mesmo nome mas com quatro assinaturas diferentes.
Vantagens da sobrecarga
The advantage of overloading a procedure is in the flexibility of the call. Para usar o post procedimento declarado no exemplo anterior, o código de chamada pode obter a identificação do cliente como um String ou um Integere então chamar o mesmo procedimento em cada caso. O exemplo a seguir ilustra isso:
Imports MSVB = Microsoft.VisualBasic
Dim customer As String
Dim accountNum As Integer
Dim amount As Single
customer = MSVB.Interaction.InputBox("Enter customer name or number")
amount = MSVB.Interaction.InputBox("Enter transaction amount")
Try
accountNum = CInt(customer)
Call post(accountNum, amount)
Catch
Call post(customer, amount)
End Try
Consulte também
Tarefas
Como: Definir várias versões de um procedimento (Visual Basic)
Como: Chamar um procedimento sobrecarregado (Visual Basic)
Como: Sobrecarregar um procedimento que recebe parâmetros opcionais (Visual Basic)
Como: Sobrecarregar um procedimento que recebe um número indefinido de parâmetros (Visual Basic)
Referência
Conceitos
Considerações sobre procedimentos de sobrecarga (Visual Basic)