Compartir a través de


Procedimientos de propiedad (Visual Basic)

Un procedimiento de propiedad es una serie de instrucciones de Visual Basic que manipulan una propiedad personalizada en un módulo, clase o estructura. Los procedimientos Property también se conocen como descriptores de acceso de propiedades.

Visual Basic proporciona los procedimientos de propiedad siguientes:

  • Un procedimiento Get devuelve el valor de una propiedad. Se le llama al tener acceso a la propiedad en una expresión.

  • Un procedimiento Set establece una propiedad en un valor, incluida una referencia a objeto. Se le llama al asignar un valor a la propiedad.

Se suelen definir procedimientos de propiedad en pares, mediante las instrucciones Get y Set, pero también se puede definir uno de los procedimientos solamente si la propiedad es de sólo lectura (Get (Instrucción)) o de sólo escritura (Instrucción Set (Visual Basic)).

Las propiedades pueden definirse en clases, estructuras y módulos. Las propiedades son Public de manera predeterminada, lo que significa que es posible llamarlas desde cualquier parte de la aplicación que tenga acceso al contenedor de propiedades.

Para consultar una comparación de propiedades y variables, vea Diferencias entre propiedades y variables en Visual Basic.

Sintaxis de la declaración

Una propiedad en sí se define como un bloque de código delimitado por las instrucciones Property (Instrucción) y End Property. Dentro de este bloque, cada procedimiento de propiedad aparece como un bloque interno incluido entre una instrucción de declaración (Get o Set) y la declaración End correspondiente.

La sintaxis para declarar una propiedad y sus procedimientos es la siguiente:

[Default] [modifiers] Property propertyname[(parameterlist)] As datatype

[accesslevel] Get

' Statements of the Get procedure.

' The following statement returns expression as the property's value.

Return expression

End Get

[accesslevel] Set[(ByVal newvalue As datatype)]

' Statements of the Set procedure.

' The following statement assigns newvalue as the property's value.

lvalue = newvalue

End Set

End Property

Los modifiers pueden especificar un nivel de acceso e información relativo a la sobrecarga, al reemplazo, uso compartido y sombreado, y si la propiedad es de sólo lectura o de sólo escritura. El access level del procedimiento Get o Set puede ser cualquier nivel más restrictivo que el nivel de acceso especificado por la propiedad en sí. Para obtener más información, vea Property (Instrucción).

Tipo de datos

El tipo de datos de una propiedad y el nivel de acceso principal están definidos en la instrucción Property y no en los procedimientos de propiedad. Una propiedad puede tener sólo un tipo de datos. Por ejemplo, no puede definirse una propiedad para que almacene un valor Decimal y que recupere un valor Double.

Nivel de acceso

Sin embargo, puede definir un nivel de acceso principal para una propiedad y restringir aún más el nivel de acceso en uno de sus procedimientos de propiedad. Por ejemplo, puede definir una propiedad Public y, a continuación, definir un procedimiento Private Set. El procedimiento Get sigue siendo Public. Puede cambiar el nivel de acceso en sólo uno de los procedimientos de una propiedad y que sea aún más restrictivo que el nivel de acceso principal. Para obtener más información, vea Cómo: Declarar una propiedad con niveles de acceso mixtos (Visual Basic).

Declaración de parámetros

Los parámetros se declaran de la misma manera que se declara Subprocedimientos (Visual Basic), excepto que el mecanismo para pasar argumentos debe ser ByVal.

La sintaxis de los parámetros de una lista de parámetros es la siguiente:

[Optional] ByVal [ParamArray] parametername As datatype

Si el parámetro es opcional, debe proporcionar también un valor predeterminado como parte de su declaración. La sintaxis para especificar un valor predeterminado es la siguiente:

Optional ByVal parametername As datatype = defaultvalue

Valor de propiedad

En un procedimiento Get, el valor devuelto se suministra a la expresión de llamada como valor de la propiedad.

En un procedimiento Set, el nuevo valor de la propiedad se pasa al parámetro de la instrucción Set. Si un parámetro se declara de forma explícita, el tipo de datos de éste debe ser el mismo que el de la propiedad. Si no se declara un parámetro, el compilador utiliza el parámetro implícito Value para representar el nuevo valor que se va a asignar a la propiedad.

Sintaxis de llamada

Se invoca un procedimiento de propiedad implícitamente haciendo referencia a la propiedad. Se utiliza el nombre de la propiedad del mismo modo que si se tratase del nombre de una variable, a excepción de que se deben suministrar valores para todos los argumentos que no sean opcionales e incluir la lista de argumentos entre paréntesis. Si no se proporcionan argumentos, se puede omitir el paréntesis.

La sintaxis de una llamada implícita a un procedimiento Set es la siguiente:

propertyname[(argumentlist)] = expression

La sintaxis de una llamada implícita a un procedimiento Get es la siguiente:

lvalue = propertyname[(argumentlist)]

Do While (propertyname[(argumentlist)] > expression)

Ejemplo de declaración y llamada

La propiedad siguiente almacena un nombre completo como dos nombres constitutivos, el nombre y el apellido. Cuando el código de llamada lee fullName, el procedimiento Get combina los dos nombres constitutivos y devuelve el nombre completo. Cuando el código de llamada asigna un nuevo nombre completo, el procedimiento Set intenta dividirlo en dos nombres constitutivos. Si no encuentra espacio, lo almacena como nombre.

Dim firstName, lastName As String
Property fullName() As String
    Get
      If lastName = "" Then
          Return firstName
      Else
          Return firstName & " " & lastName
      End If

    End Get
    Set(ByVal Value As String)
        Dim space As Integer = Value.IndexOf(" ")
        If space < 0 Then
            firstName = Value
            lastName = ""
        Else
            firstName = Value.Substring(0, space)
            lastName = Value.Substring(space + 1)
        End If
    End Set
End Property

El ejemplo siguiente muestra las llamadas típicas a los procedimientos de propiedad de fullName.

fullName = "MyFirstName MyLastName"
MsgBox(fullName)

Vea también

Tareas

Cómo: Crear una propiedad (Visual Basic)

Cómo: Llamar a un procedimiento de propiedad (Visual Basic)

Cómo: Declarar y llamar a una propiedad predeterminada en Visual Basic

Cómo: Establecer un valor en una propiedad (Visual Basic)

Cómo: Obtener un valor de una propiedad (Visual Basic)

Conceptos

Procedimientos en Visual Basic

Procedimientos de función (Visual Basic)

Procedimientos de operador (Visual Basic)

Argumentos y parámetros de procedimiento (Visual Basic)

Diferencias entre propiedades y variables en Visual Basic