Cómo: Agregar campos y propiedades a una clase

Artículo
10/07/2008

Actualización: noviembre 2007

Se pueden utilizar tanto campos como propiedades para almacenar información en un objeto. Aunque los campos y las propiedades son muy difíciles de distinguir desde una perspectiva de aplicación de cliente, se declaran de forma diferente en una clase. Mientras que los campos son simplemente variables públicas que una clase expone, las propiedades utilizan procedimientos Property para controlar cómo se establecen y devuelven valores.

Para agregar un campo a una clase

Declare una variable pública en la definición de clase, como en el código siguiente:
```
Class ThisClass
    Public ThisField As String
End Class
```

Para agregar una propiedad a una clase

Declare una variable local en la clase para almacenar el valor de la propiedad. Este paso es necesario puesto que las propiedades no asignan almacenamiento por sí mismas. A fin de proteger sus valores contra la modificación directa, las variables que se utilizan para almacenar valores de propiedad deben declarase como Private.
Escriba modificadores antes de las declaraciones de propiedad, como Public y Shared, según corresponda. Utilice la palabra clave Property para declarar el nombre de la propiedad y declare el tipo de datos que la propiedad almacena y devuelve.
Defina los procedimientos de propiedad Get y Set dentro de la definición de propiedad. Los procedimientos de propiedad Get se utilizan para devolver el valor de una propiedad y son aproximadamente equivalentes a las funciones de sintaxis. No aceptan ningún argumento y se pueden utilizar para devolver el valor de variables local privadas declaradas dentro de la clase utilizada para almacenar el valor de la propiedad. Los procedimientos de propiedad Set se utilizan para establecer el valor de una propiedad; tienen un parámetro, llamado normalmente Value, con el mismo tipo de datos que la propiedad en sí. Cada vez que se cambia el valor de la propiedad, se pasa Value al procedimiento de propiedad Set, donde se puede validar y almacenar en una variable local.
Finalice los procedimientos de propiedad Get y Set con las instrucciones End Get y End Set correspondientes.

Finalice el bloque de propiedad con una instrucción End Property.

Nota:
Si está trabajando dentro del entorno de desarrollo integrado (IDE) de Visual Studio, puede dirigirlo para crear procedimientos de propiedad Get y Set vacíos. Escriba Property NombreProp As TipoDeDatos (donde NombreProp es el nombre de la propiedad y TipoDeDatos es un tipo de datos específico, por ejemplo Integer), y los procedimientos de propiedad aparecen en el Editor de código.

En el siguiente ejemplo se declara una propiedad en una clase:

Class ThisClass
    Private m_PropVal As String
    Public Property One() As String
        Get
            ' Return the value stored in the local variable.
            Return m_PropVal
        End Get
        Set(ByVal Value As String)
            ' Store the value in a local variable.
            m_PropVal = Value
        End Set
    End Property
End Class

Cuando se crea una instancia de ThisClass y se establece el valor de la propiedad One, se llama al procedimiento de propiedad Set y se pasa el valor en el parámetro Value, que se almacena en una variable local denominada m_PropVal. Cuando se recupera el valor de esta propiedad, se llama al procedimiento de propiedad Get como función y devuelve el valor almacenado en la variable local m_PropVal.

Vea también

Cómo: Agregar campos y propiedades a una clase

Para agregar un campo a una clase

Para agregar una propiedad a una clase

Vea también

Tareas

Conceptos

Referencia

Recursos adicionales