Cómo: Definir varias versiones de un procedimiento

Artículo
10/07/2008

Actualización: noviembre 2007

Puede definir un procedimiento en varias versiones sobrecargándolo, es decir, utilizando el mismo nombre pero una lista de parámetros diferente para cada versión. El propósito de sobrecargar un procedimiento es definir varias versiones de un procedimiento estrechamente relacionadas sin tener que distinguirlas por su nombre.

Para obtener más información, vea Sobrecarga de procedimientos.

Para definir varias versiones de un procedimiento

Escriba una instrucción de declaración Sub o Function para cada versión del procedimiento que desea definir. Utilice el mismo nombre de procedimiento en cada declaración.
Anteponga la palabra clave Sub o Function en cada declaración con la palabra clave Overloads. Si lo desea, puede omitir Overloads en las declaraciones, pero si incluye esta palabra clave en alguna declaración, deberá incluirla en todas.
Después de cada instrucción de declaración, escriba el código de procedimiento para que controle el caso concreto en el que el código de llamada proporciona argumentos que coinciden con la lista de parámetros de esa versión. No es necesario que compruebe los parámetros que ha proporcionado el código de llamada. Visual Basic transfiere el control a la versión correspondiente de su procedimiento.
Finalice cada versión del procedimiento con la instrucción End Sub o End Function

Ejemplo

En el ejemplo siguiente se define un procedimiento Sub que contabiliza una transacción en el balance de un cliente. El procedimiento utiliza la palabra clave Overloads para definir dos versiones del procedimiento, una que acepta al cliente por nombre y otra que lo acepta por número de cuenta.

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

El código de llamada puede obtener la identificación del cliente como una String o como un Integer, pero a continuación utiliza la misma instrucción de llamada en los dos casos.

Para obtener información sobre cómo llamar a estas versiones del procedimiento post, vea Cómo: Llamar a un procedimiento sobrecargado.