Get — Instrukcja

Oświadcza, Get procedury właściwości używane do pobierania wartości właściwości.

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

Części

Termin

Definicja

attributelist

Opcjonalne.Zobacz listy atrybutów.

accessmodifier

Opcjonalne, na co najwyżej jeden z Get i Set sprawozdań w tej właściwości.Może mieć jedną z następujących czynności:

See Poziomy dostępu w Visual Basic.

statements

Opcjonalne.Jedną lub więcej instrukcji, które są uruchamiane, gdy Get wywołania procedury właściwości.

End Get

Wymagane.Kończy definicję Get właściwość procedury.

Uwagi

Każda właściwość musi mieć Get właściwość procedury chyba, że właściwość jest oznaczony jako WriteOnly.Get Procedura jest używane do zwracania bieżącą wartość właściwości.

Visual Basic automatycznie wywołuje właściwość Get procedury, gdy wyrażenie żąda wartość właściwości.

Treść deklaracji właściwości może zawierać tylko właściwości Get i Set procedury między Property — Instrukcja i End Property instrukcji.Nie można zapisać coś innego niż te procedury.W szczególności nie może być przechowywać bieżącą wartość właściwości.Tej wartości poza właściwości, muszą być przechowywane, ponieważ jeśli przechowywane wewnątrz albo procedury właściwości, inne procedury właściwości nie można go dostęp.Podejście zwykle jest do przechowywania wartości w Private (Visual Basic) Zmienna zadeklarowana na tym samym poziomie, co właściwość.Należy zdefiniować Get procedury wewnątrz właściwość, której dotyczy.

Get Procedury domyślne do poziomu dostępu, zawierająca go właściwość, chyba że używasz accessmodifier w Get instrukcji.

Zasady

  • Mieszane poziomy dostępu. Jeśli podczas definiowania właściwości odczytu i zapisu, można opcjonalnie określić poziom dostępu dla albo Get lub Set procedura, ale nie oba jednocześnie.Jeśli to zrobisz, poziom dostępu procedury musi być bardziej restrykcyjny niż poziom dostępu do właściwości.Na przykład, jeśli właściwość jest zadeklarowana jako Friend, można zadeklarować Get procedury Private, ale nie Public.

    Jeśli podczas definiowania ReadOnly właściwość, Get procedury reprezentuje właściwość całego.Nie można zadeklarować poziom dostępu różnych Get, ponieważ ustawią dwa poziomy dostępu dla właściwości.

  • Zwraca typ.Property — Instrukcja Można zadeklarować typ danych zwracanych wartości.Get Procedurę automatycznie zwraca typ danych.Można określić dowolny typ danych lub nazwę wyliczenia, struktury, klasy lub interfejsu.

    Jeśli Property instrukcja nie określono returntype, procedura zwraca Object.

Zachowanie

  • Zwracanie z procedury. Gdy Get procedura zwracająca kod wywołujący, wykonanie nadal w oświadczeniu, że żądana wartość właściwości.

    GetWłaściwość procedur może zwracać wartość za pomocą Return — Instrukcja (Visual Basic) lub przypisując wartość zwracana nazwa właściwości.Aby uzyskać więcej informacji, zobacz "Zwraca wartość" w Function — Instrukcja (Visual Basic).

    Exit Property i Return sprawozdań spowodować natychmiastowe wyjścia z procedury właściwości.Dowolna liczba Exit Property i Return sprawozdań może pojawiać się wszędzie w procedurze i mogą mieszać Exit Property i Return instrukcji.

  • Zwraca wartość. W celu zwrócenia wartości z Get procedury, można przypisać wartości do nazwy właściwości lub umieścić je w Return — Instrukcja (Visual Basic).Return Instrukcja jednocześnie przypisuje Get procedura zwraca wartość i kończy procedurę.

    Jeśli korzystasz z Exit Property bez przypisywania wartości do nazwy właściwości, Get procedury, zwraca domyślną wartość dla właściwości typu danych.Aby uzyskać więcej informacji, zobacz "Zwraca wartość" w Function — Instrukcja (Visual Basic).

    Poniższy przykład ilustruje dwa sposoby właściwości tylko do odczytu quoteForTheDay może zwracać wartość, która odbyła się w zmiennej prywatnej 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
    

Przykład

W poniższym przykładzie użyto Get instrukcji, aby zwrócić wartość właściwości.

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

Zobacz też

Zadania

Wskazówki: definiowanie klas (Visual Basic)

Informacje

Set — Instrukcja (Visual Basic)

Property — Instrukcja

Exit — Instrukcja (Visual Basic)

Inne zasoby

Obiekty i klasy w Visual Basic