Get-instructie

Artikel
03/13/2024

Declareert een Get eigenschapsprocedure die wordt gebruikt om de waarde van een eigenschap op te halen.

Syntaxis

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

generator

Term	Definitie
`attributelist`	Optioneel. Zie de lijst met kenmerken.
`accessmodifier`	Optioneel op maximaal één van de `Get` en `Set` instructies in deze eigenschap. Dit kan een van de volgende zijn: - Beschermd - Vriend - Privé - `Protected Friend` Zie Access-niveaus in Visual Basic.
`statements`	Optioneel. Een of meer instructies die worden uitgevoerd wanneer de `Get` eigenschapsprocedure wordt aangeroepen.
`End Get`	Vereist. Hiermee wordt de definitie van de `Get` eigenschapsprocedure beëindigd.

Opmerkingen

Elke eigenschap moet een Get eigenschapsprocedure hebben, tenzij de eigenschap is gemarkeerd WriteOnly. De Get procedure wordt gebruikt om de huidige waarde van de eigenschap te retourneren.

Visual Basic roept automatisch de procedure van Get een eigenschap aan wanneer een expressie de waarde van de eigenschap aanvraagt.

De hoofdtekst van de eigenschapsdeclaratie kan alleen de Get eigenschappen en Set procedures tussen de eigenschapsinstructie en de End Property instructie bevatten. Het kan niets anders dan die procedures opslaan. Met name kan de huidige waarde van de eigenschap niet worden opgeslagen. U moet deze waarde buiten de eigenschap opslaan, omdat de andere eigenschapsprocedure geen toegang heeft als u deze in een van de eigenschapsprocedures opslaat. De gebruikelijke benadering is het opslaan van de waarde in een privévariabele die is gedeclareerd op hetzelfde niveau als de eigenschap. U moet een Get procedure definiëren binnen de eigenschap waarop deze van toepassing is.

De Get procedure wordt standaard ingesteld op het toegangsniveau van de bijbehorende eigenschap, tenzij u deze in de Get instructie gebruiktaccessmodifier.

Regels

Gemengde toegangsniveaus. Als u een eigenschap lezen/schrijven definieert, kunt u desgewenst een ander toegangsniveau opgeven voor de Get of de Set procedure, maar niet voor beide. Als u dit doet, moet het toegangsniveau van de procedure meer beperkend zijn dan het toegangsniveau van de eigenschap. Als de eigenschap bijvoorbeeld is gedeclareerd Friend, kunt u de Get procedure Privatedeclareren, maar niet Public.

Als u een ReadOnly eigenschap definieert, vertegenwoordigt de Get procedure de hele eigenschap. U kunt geen ander toegangsniveau declareren voor Get, omdat hiermee twee toegangsniveaus voor de eigenschap worden ingesteld.
Retourtype. De eigenschapsinstructie kan het gegevenstype declareren van de waarde die wordt geretourneerd. De Get procedure retourneert automatisch dat gegevenstype. U kunt elk gegevenstype of de naam van een opsomming, structuur, klasse of interface opgeven.

Als de Property instructie niet opgeeft returntype, wordt de procedure geretourneerd Object.

Gedrag

Terugkeren vanuit een procedure. Wanneer de Get procedure terugkeert naar de aanroepende code, wordt de uitvoering voortgezet binnen de instructie waarin de eigenschapswaarde is aangevraagd.

Get procedures voor eigenschappen kunnen een waarde retourneren met behulp van de retourinstructie of door de retourwaarde toe te wijzen aan de naam van de eigenschap. Zie 'Retourwaarde' in functie-instructie voor meer informatie.

De Exit Property instructies Return veroorzaken een onmiddellijke uitgang van een eigenschapsprocedure. Elk aantal Exit Property instructies Return en instructies kan overal in de procedure worden weergegeven en u kunt deze combineren Exit Property en Return instructies.
Retourwaarde. Als u een waarde wilt retourneren uit een Get procedure, kunt u de waarde toewijzen aan de naam van de eigenschap of deze opnemen in een retourinstructie. De Return instructie wijst tegelijkertijd de retourwaarde van de Get procedure toe en sluit de procedure af.

Als u Exit Property zonder een waarde toe te wijzen aan de eigenschapsnaam, retourneert de Get procedure de standaardwaarde voor het gegevenstype van de eigenschap. Zie 'Retourwaarde' in functie-instructie voor meer informatie.

In het volgende voorbeeld ziet u twee manieren waarop de eigenschap quoteForTheDay Alleen-lezen de waarde in de privévariabele quoteValuekan retourneren.
```
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
```

Opmerking

In het volgende voorbeeld wordt de Get instructie gebruikt om de waarde van een eigenschap te retourneren.

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

Delen via