Istruzione Get

Consente di dichiarare una routine di proprietà Get utilizzata per recuperare il valore di una proprietà.

[ <attributelist> ] [ accessmodifier ] Get()
    [ statements ]
End Get

Parti

Argomento

Definizione

attributelist

Facoltativo. Vedere Elenco degli attributi.

accessmodifier

Facoltativo per al massimo una delle istruzioni Get e Set in questa proprietà e può essere ad esempio uno dei seguenti:

Vedere Livelli di accesso in Visual Basic.

statements

Facoltativo. Una o più istruzioni eseguite quando viene chiamata la routine di proprietà Get.

End Get

Obbligatoria. Consente di terminare la definizione della routine di proprietà Get.

Note

Per ogni proprietà deve esistere una routine di proprietà Get a meno che la proprietà non sia contrassegnata come WriteOnly. La routine Get viene utilizzata per ottenere il valore corrente della proprietà.

In Visual Basic viene automaticamente chiamata la routine Get di una proprietà quando un'espressione richiede il valore della proprietà.

All'interno del corpo della dichiarazione di proprietà possono essere contenute solo le routine Get e Set della proprietà fra le istruzioni Istruzione Property e End Property. Non è possibile memorizzare altro all'infuori di queste routine. In particolare, non è possibile memorizzare il valore corrente della proprietà. Questo valore va memorizzarlo al di fuori della proprietà. Se lo si inserisce all'interno di una delle routine infatti, l'altra non potrà accedervi. In genere questo valore viene memorizzato in una variabile Private (Visual Basic) dichiarata allo stesso livello della proprietà. Una routine Get deve essere definita all'interno della proprietà a cui si riferisce.

La routine Get assume per impostazione predefinita il livello di accesso della proprietà che la contiene, a meno che non si utilizzi il parametro accessmodifier nell'istruzione Get.

Regole

  • Livelli di accesso misto. Se si definisce una proprietà di lettura/scrittura, è eventualmente possibile specificare un livello di accesso diverso per la routine Get o Set, ma non per entrambe. Il livello di accesso della routine deve essere più restrittivo rispetto a quello della proprietà. Se ad esempio la proprietà è dichiarata Friend, la routine Get può essere dichiarata Private, ma non Public.

    Se si sta definendo una proprietà ReadOnly, la routine Get rappresenta l'intera proprietà. Non è possibile dichiarare un livello di accesso diverso per Get in quanto altrimenti per la proprietà verrebbero specificati due livelli di accesso.

  • Tipo restituito. L'Istruzione Property può dichiarare il tipo di dati del valore restituito. La routine Get restituisce automaticamente quel tipo di dati. È possibile specificare qualsiasi tipo di dati o il nome di un'enumerazione, struttura, classe o interfaccia.

    Se nell'istruzione Property non è specificato returntype, la routine restituisce Object.

Comportamento

  • Chiusura di una routine. Quando la routine Get torna al codice chiamante, l'esecuzione continua all'interno dell'istruzione che ha richiesto il valore della proprietà.

    Le routine di proprietà Get possono restituire un valore utilizzando l'Istruzione Return (Visual Basic) oppure assegnando il valore restituito al nome della proprietà. Per ulteriori informazioni, vedere "Valore restituito" in Istruzione Function (Visual Basic).

    Le istruzioni Exit Property e Return consentono di uscire immediatamente da una routine di proprietà. Qualsiasi numero delle istruzioni Exit Property e Return può essere visualizzato in un punto qualsiasi della procedura ed è possibile mescolare le istruzioni Exit Property e Return.

  • Valore restituito. Per ottenere un valore da una routine Get è possibile assegnare il valore al nome della proprietà oppure includerlo in un'Istruzione Return (Visual Basic). L'istruzione Return assegna il valore restituito della routine Get e contemporaneamente consente di uscire dalla routine.

    Se si utilizza l'istruzione Exit Property senza assegnare un valore al nome della proprietà, la routine Get restituisce il valore predefinito per il tipo di dati della proprietà. Per ulteriori informazioni, vedere "Valore restituito" in Istruzione Function (Visual Basic).

    Nell'esempio seguente sono illustrati due metodi che consentono alla proprietà di sola lettura quoteForTheDay di restituire il valore contenuto nella variabile privata quoteValue.

    Private quoteValue As String = "No quote assigned yet."
    
    ReadOnly Property quoteForTheDay() As String
        Get
            quoteForTheDay = quoteValue
            Exit Property
        End Get
    End Property
    
    ReadOnly Property quoteForTheDay() As String
        Get
            Return quoteValue
        End Get
    End Property
    

Esempio

Nell'esempio seguente l'istruzione Get viene utilizzata per restituire il valore di una proprietà.

Class propClass
    ' Define a private local variable to store the property value.
    Private currentTime As String
    ' Define the read-only property.
    Public ReadOnly Property dateAndTime() As String
        Get
            ' The Get procedure is called automatically when the
            ' value of the property is retrieved.
            currentTime = CStr(Now)
            ' Return the date and time As a string.
            Return currentTime
        End Get
    End Property
End Class

Vedere anche

Attività

Procedura dettagliata: definizione delle classi (Visual Basic)

Riferimenti

Istruzione Set (Visual Basic)

Istruzione Property

Istruzione Exit (Visual Basic)

Altre risorse

Oggetti e classi in Visual Basic