ReadOnly (Visual Basic)

Articolo
08/11/2011

Specifica che è possibile leggere ma non scrivere una variabile o una proprietà.

Note

Regole

Contesto della dichiarazione. È possibile utilizzare la parola chiave ReadOnly solo a livello di modulo. In altri termini, il contesto della dichiarazione per un elemento ReadOnly deve essere una classe, una struttura o un modulo e non può essere un file di origine, uno spazio dei nomi o una routine.
Modificatori combinati. Non è possibile specificare ReadOnly insieme a Static nella stessa dichiarazione.
Assegnazione di un valore. Il codice che utilizza una proprietà ReadOnly non può impostarne il valore, ma il codice che può accedere alla memoria sottostante può assegnare o modificare tale valore in qualsiasi momento.

È possibile assegnare un valore a una variabile ReadOnly solo nella relativa dichiarazione o nel costruttore di una classe o di una struttura in cui la variabile è definita.

Utilizzo di una variabile ReadOnly

Esistono casi in cui non è possibile utilizzare un'Istruzione Const (Visual Basic) per dichiarare e assegnare un valore costante. Ad esempio, è possibile che l'istruzione Const non accetti il tipo di dati che si desidera assegnare o che non si sia in grado di calcolare il valore in fase di compilazione con un'espressione costante. È possibile perfino che non si conosca tale valore in fase di compilazione. In questi casi, è possibile utilizzare una variabile ReadOnly per contenere un valore costante.

Nota sulla sicurezza
Se il tipo di dati della variabile è un tipo di riferimento, ad esempio una matrice o un'istanza di classe, i relativi membri possono essere modificati anche se la variabile stessa è ReadOnly. Nell'esempio riportato di seguito viene illustrata questa situazione.

ReadOnly characterArray() As Char = {"x"c, "y"c, "z"c}

Sub changeArrayElement()

characterArray(1) = "M"c

End Sub

Una volta inizializzata, la matrice a cui punta characterArray() conterrà "x", "y" e "z". Poiché la variabile characterArray è ReadOnly, non è possibile modificarne il valore dopo l'inizializzazione, ovvero non è possibile assegnare ad essa una nuova matrice. È tuttavia possibile modificare i valori di uno o più membri della matrice. In seguito a una chiamata alla routine changeArrayElement, la matrice a cui punta characterArray() conterrà "x", "M" e "z".

Questa situazione equivale a dichiarare un parametro di routine ByVal (Visual Basic), impedendo alla routine di modificare l'argomento chiamante ma non i relativi membri.

Esempio

Nell'esempio riportato di seguito viene definita una proprietà ReadOnly per la data di assunzione di un dipendente. La classe memorizza internamente il valore della proprietà come variabile Private e tale valore può essere modificato solo dal codice interno alla classe. Tuttavia, poiché la proprietà è Public, può essere letta da qualsiasi codice in grado di accedere alla classe.

Class employee
    ' Only code inside class employee can change the value of hireDateValue.
    Private hireDateValue As Date
    ' Any code that can access class employee can read property dateHired.
    Public ReadOnly Property dateHired() As Date
        Get
            Return hireDateValue
        End Get
    End Property
End Class

Il modificatore ReadOnly può essere utilizzato nei seguenti contesti:

Istruzione Dim

Istruzione Property