Hiermee declareert u de naam, argumenten en programmacode die het hoofddeel vormen van een procedure Property die de waarde van een eigenschap ophaalt.
Syntaxis
[Public | Private | Friend] [Static] Property Get naam [(argumenten)] [As type]
[instructies]
[naam = expressie]
[Exit Property]
[instructies]
[naam = expressie]
End Property
De syntaxis van de instructie Property Get bevat de volgende onderdelen:
| Onderdeel | Beschrijving |
|---|---|
| Public | Optioneel. Geeft aan dat de procedure Property Get toegankelijk is voor alle andere procedures in alle modules. Als u dit argument gebruikt in een persoonlijke module (een module met een instructie Option Private), is de procedure niet beschikbaar buiten het project. |
| Private | Optioneel. Geeft aan dat de procedure Property Get alleen toegankelijk is voor andere procedures in de module waarin deze werd gedeclareerd. |
| Friend | Optioneel. Wordt alleen gebruikt in een klassenmodule. Geeft aan dat de procedure Property Get tijdens het gehele project zichtbaar is, maar niet voor een controller van een exemplaar van een object. |
| Static | Optioneel. Geeft aan dat de lokale variabelen van de procedure Property Get tussen oproepen worden opgeslagen. Het onderdeel Static is niet van invloed op variabelen die buiten de procedure Property Get zijn gedeclareerd, zelfs niet als deze in dezelfde procedure worden gebruikt. |
| naam | Vereist. De naam van de procedure Property Get. Voor deze naam gelden de standaardregels voor naamgeving van een variabele. U kunt echter niet dezelfde naam gebruiken als van een procedure Property Let of Property Set in dezelfde module. |
| argumenten | Optioneel. Een lijst met variabelen die argumenten aangeven die worden doorgegeven aan de procedure Property Get wanneer deze wordt opgeroepen. Meerdere variabelen worden door komma's van elkaar gescheiden. Overeenkomstige argumenten in een procedure Property Get en Property Let (indien aanwezig) moeten dezelfde naam en hetzelfde gegevenstype hebben. |
| type | Optioneel. Het gegevenstype van de variabele dat als resultaat wordt gegeven door de procedure Property Get. Toegestaan zijn: Byte, Boolean, Integer, Long, Currency, Single, Double, Decimal (momenteel niet ondersteund), Date, String (uitgezonderd tekenreeksen met vaste lengte), Object, Variant, een door de gebruiker gedefinieerd type en Arrays.
In een procedure Property Get moet het resultaat voor type hetzelfde gegevenstype zijn als het laatste (of enige) argument in de overeenkomstige procedure Property Let (indien aanwezig) waarmee de waarde wordt gedefinieerd, die wordt toegewezen aan de eigenschap aan de rechterzijde van de expressie. |
| instructies | Optioneel. Een groep instructies die wordt uitgevoerd in het hoofddeel van de procedure Property Get. |
| expressie | Optioneel. De waarde van de eigenschap die als resultaat wordt gegeven van de procedure die u definieert met de instructie Property Get. |
Het argument argumenten bevat de volgende syntaxis en onderdelen:
[Optional] [ByVal | ByRef] [ParamArray] varnaam[( )] [As type] [=standaardwaarde]
| Onderdeel | Beschrijving |
|---|---|
| Optional | Optioneel. Geeft aan dat een argument niet nodig is. Als u dit sleutelwoord gebruikt, moeten alle volgende argumenten in argumenten ook optioneel zijn en worden gedeclareerd met het sleutelwoord Optional. |
| ByVal | Optioneel. Geeft aan dat het argument via een waarde wordt doorgegeven. |
| ByRef | Optioneel. Geeft aan dat het argument via een verwijzing wordt doorgegeven. De standaardinstelling in Visual Basic is ByRef. |
| ParamArray | Optioneel. Wordt alleen gebruikt als het laatste argument in argumenten om aan te geven dat het laatste argument een Optional-matrix is met onderdelen van het type Variant. Met het sleutelwoord ParamArray kunt u een willekeurig aantal argumenten opnemen. U mag ParamArray niet gebruiken met de sleutelwoorden ByVal, ByRef of Optional. |
| Varnaam | Vereist. De naam van de variabele die het argument aangeeft dat aan de procedure wordt doorgegeven. Hiervoor gelden de standaardregels voor naamgeving van een variabele. |
| type | Optioneel. Het gegevenstype van het argument dat wordt doorgegeven aan de procedure. De volgende typen zijn geldig: Byte, Boolean, Integer, Long, Currency, Single, Double, Decimal (momenteel niet ondersteund), Date, String (uitsluitend met variabele lengte), Object, Variant of een specifiek objecttype. Als de parameter niet Optional is, mag ook een door de gebruiker gedefinieerd type worden opgegeven. |
| standaardwaarde | Optioneel. Een willekeurige constante of constantenexpressie. Alleen geldig voor Optional-parameters. Als het type een Object is, kan een expliciete standaardwaarde alleen Nothing zijn. |
Notities
Als het argument Public, Private of Friend niet expliciet is opgegeven, is Public de standaardinstelling voor de procedures Property. Als u het argument Static niet gebruikt, worden de waarden van lokale variabelen niet bewaard tussen de verschillende procedureoproepen. Het sleutelwoord Friend kan alleen worden gebruikt in klassenmodules. Maar procedures kunnen in elke module van een project toegang tot procedures Friend krijgen. Een procedure Friend verschijnt niet in de typebibliotheek van de bijbehorende bovenliggende klasse en kan ook niet laat gebonden zijn.
Alle uitvoerbare programmacode moet in de procedure worden opgenomen. U kunt een procedure Property Get niet definiδren binnen een andere procedure Property, Sub of Function.
De instructie Exit Property zorgt ervoor dat de procedure Property Get onmiddellijk wordt verlaten. De uitvoering van het programma gaat verder met de instructie die volgt op de instructie waarmee de procedure Property Get werd opgeroepen. U kunt een willekeurig aantal instructies Exit Property opnemen op elke plaats in een procedure Property Get.
Evenals de procedures Sub en Property Let is de procedure Property Get een afzonderlijke procedure waarvoor u argumenten kunt opgeven, instructies kunt uitvoeren of de waarden van de argumenten kunt wijzigen. In tegenstelling tot de procedures Sub en Property Let, kunt u een procedure Property Get net als een Function of eigenschapnaam aan de rechterzijde van een expressie gebruiken als u de waarde van de eigenschap als resultaat wilt geven.