|
|
Property Let (Instrucción)
Declara el nombre, los argumentos, y el código que forman el cuerpo de un procedimiento Property Let, el cual asigna un valor a una propiedad.
Sintaxis
[Public | Private | Friend] [Static] Property Let nombre ([lista_argumentos,] valor)
[instrucciones]
[Exit Property]
[instrucciones]
End Property
La sintaxis de la instrucción Property Let consta de las siguientes partes:
| Parte | Descripción |
|---|---|
| Public | Opcional. Indica que el procedimiento Property Let es accesible para todos los demás procedimientos de todos los módulos. Si se usa en un módulo que contiene una instrucción Option Private, el procedimiento no se encuentra disponible fuera del proyecto. |
| Private | Opcional. Indica que el procedimiento Property Let es accesible sólo para otros procedimientos del módulo donde se ha declarado. |
| Friend | Opcional. Sólo se utiliza en un módulo de clase. Indica que el procedimiento Property Let es visible a través del proyecto, pero no por un controlador de una instancia de un objeto. |
| Static | Opcional. Indica que las variables locales del procedimiento Property Let se conservan entre distintas llamadas. El atributo Static no afecta a las variables que se han declarado fuera del procedimiento Property Let, incluso aunque se usen en el procedimiento. |
| nombre | Requerido. Nombre del procedimiento Property Let; sigue las convenciones estándar de nombres de variables, excepto en que el nombre puede ser el mismo que el de los procedimientos Property Get o Property Set del mismo módulo. |
| lista_ argumentos |
Requerido. Lista de variables que representan argumentos que se pasan al llamar al procedimiento Property Let. Los distintos argumentos se separan mediante comas. El nombre y el tipo de datos de cada argumento de un procedimiento Property Let deben ser iguales que los argumentos correspondientes de un procedimiento Property Get. |
| valor | Requerido. Variable que contiene el valor que se asigna a la propiedad. Cuando se llama al procedimiento, este argumento aparece en la parte derecha de la expresión que hace la llamada. El tipo de datos de valor debe ser el mismo que el del tipo devuelto por el correspondiente procedimiento Property Get. |
| instrucciones | Opcional. Cualquier grupo de instrucciones que se ejecute dentro del procedimiento Property Let. |
El argumento lista_argumentos consta de las siguientes partes y sintaxis:
[Optional] [ByVal | ByRef] [ParamArray] nombre_variable[( )] [As tipo] [= valor_predeterminado]
| Parte | Descripción |
|---|---|
| Optional | Opcional. Indica que no se necesita un argumento. Si se utiliza, todos los argumentos subsiguientes de lista_argumentos también deben ser opcionales y se deben declarar mediante la palabra clave Optional. Observe que la parte derecha de una expresión Property Let no puede ser Optional. |
| ByVal | Opcional. Indica que el argumento se pasa por valor. |
| ByRef | Opcional. Indica que el argumento se pasa por referencia. ByRef es el argumento predeterminado en Visual Basic. |
| ParamArray | Opcional. Sólo se utiliza como el último argumento de lista_argumentos para indicar que el argumento final es una matriz Optional de elementos tipo Variant. La palabra clave ParamArray le permite proporcionar un número arbitrario de argumentos. No se puede utilizar con ByVal, ByRef u Optional. |
| nombre_ variable |
Requerido. El nombre de la variable que representa al argumento; sigue las convenciones estándar de nombres de variables. |
| tipo | Opcional. El tipo de datos del argumento pasado al procedimiento; puede ser Byte, Boolean, Integer, Long, Currency, Single, Double, Decimal (no admitida actualmente), Date, String (solamente de longitud variable), Object, Variant, o un tipo de objeto específico. Si el parámetro no es Optional, también se puede especificar un tipo definido por el usuario. |
| valor_ predeterminado |
Opcional. Cualquier constante o expresión de constante. Sólo es válido para parámetros Optional. Si el tipo es Object, un valor predeterminado explícito sólo puede ser Nothing. |
Nota Cualquier instrucción Property Let debe definir por lo menos un argumento para el procedimiento que define. Ese argumento (o el último argumento si hay más de uno) contiene el valor real que se asigna a la propiedad cuando se invoca el procedimiento definido por la instrucción Property Let. Ese argumento se denomina valor en la sintaxis anterior.
Comentarios
Si no se especifica explícitamente mediante Public, Private o Friend, los procedimientos Property son públicos de manera predeterminada. Si no se usa Static, el valor de las variables locales no se conserva entre distintas llamadas. La palabra clave Friend solamente se puede usar en módulos de clase. Sin embargo, los procedimientos en cualquier módulo de un proyecto pueden acceder a los procedimientos Friend. Un procedimiento Friend no aparece en la biblioteca de tipo de su clase primaria, ni se puede enlazar posteriormente.
Todo código ejecutable debe estar en procedimientos. No puede definir un procedimiento Property Let dentro de otro procedimiento Property, Sub o Function.
La instrucción Exit Property causa la inmediata salida de un procedimiento Property Let. La ejecución del programa continúa con la instrucción que sigue a la instrucción que llamó al procedimiento Property Let. Cualquier número de instrucciones Exit Property puede aparecer en cualquier lugar de un procedimiento Property Let.
Al igual que un procedimiento Function y Property Get, un procedimiento Property Let es un procedimiento distinto que puede tomar argumentos, llevar a cabo una serie de instrucciones y cambiar el valor de sus argumentos. Sin embargo, a diferencia de un procedimiento Function y Property Get, los cuales devuelven un valor, un procedimiento Property Let sólo se puede usar en el lado izquierdo de una expresión de asignación de propiedad o de una instrucción Let.