Property Get-Anweisung

Declares the name, arguments, and code that form the body of a Propertyprocedure, which gets the value of a property.

Syntax

[ Öffentlich | Privat | Freund ] [ Statisch ] Eigenschaft getname [ (arglist) ] [ Astype ]
[ statements ]
[ Name=Ausdruck ]
[ Beenden-Eigenschaft ]
[ statements ]
[ Name=Ausdruck ]
End Property

Die Syntax der Property Get -Anweisung besteht aus folgenden Teilen:

Teil Beschreibung
Public Optional. Gibt an, dass auf die Property Get-Prozedur von allen anderen Prozeduren in allen Modulen zugegriffen werden kann. Wenn die Prozedur in einem Modul verwendet wird, das eine Option Private-Anweisung enthält, ist sie außerhalb des Projekts nicht zugänglich.
Private Optional. Gibt an, dass auf die Property Get-Prozedur nur von anderen Prozeduren in dem Modul zugegriffen werden kann, in dem sie deklariert wurde.
Friend Optional. Wird nur in einem Klassenmodul verwendet. Gibt an, dass die Property Get-Prozedur im gesamten Projekt sichtbar ist, jedoch nicht für den Controller einer Objektinstanz.
Static Optional. Gibt an, dass die lokalen Variablen der Property Get-Prozedur zwischen Aufrufen beibehalten werden. Auf Variablen, die außerhalb der Property Get-Prozedur deklariert wurden, hat das Static-Attribut keinen Einfluss, selbst wenn sie in der Prozedur verwendet werden.
name Erforderlich. Name der Property Get-Prozedur ; folgt standardmäßigen Variablenbenennungskonventionen, mit der Ausnahme, dass der Name mit einer Property Let- oder Property Set-Prozedur im selben Modul identisch sein kann.
arglist Optional. Variablenliste mit den Argumenten, die an die Property Get-Prozedur bei ihrem Aufruf übergeben werden. Mehrere Argumente werden durch Kommas getrennt. Der Name und der Datentyp aller Argumente in einer Property Get-Prozedur müssen mit dem Namen und Datentyp des entsprechenden Arguments in einer Property Let-Prozedur übereinstimmen (sofern vorhanden).
type Optional. Datentyp des von der Property Get-Prozedur zurückgegebenen Werts; kann Byte, Boolean, Integer, Long, Currency, Single, Double, Decimal (derzeit nicht unterstützt), Date, String (außer fester Länge), Object, Variant, benutzerdefinierter Typ und Arrays sein.

Der Rückgabetyp einer Property Get-Prozedur muss derselbe Datentyp sein wie das letzte (oder manchmal das einzige) Argument in einer entsprechenden Property Let-Prozedur (sofern vorhanden), die den der Eigenschaft auf der rechten Seite eines Ausdrucks zugewiesenen Wert definiert.
statements Optional. Eine Gruppe von Anweisungen, die in der Property Get-Prozedur ausgeführt werden sollen.
expression Optional. Wert der Eigenschaft, die von der Prozedur zurückgegeben wird, die durch die Property Get-Anweisung definierten wurde.

Das arglist-Argument weist die folgende Syntax und folgende Teile auf:

[ Optional ] [ ByVal | ByRef ] [ ParamArray ] varname [ ( ) ] [ Astype ] [ =defaultvalue ]

Teil Beschreibung
Optional Optional. Gibt an, dass ein Argument nicht erforderlich ist. Wenn verwendet, müssen alle nachfolgenden Argumente in arglist optional sein und mithilfe des Schlüsselworts Optional deklariert werden.
ByVal Optional. Gibt an, dass das Argument nach Wert übergeben wird.
ByRef Optional. Gibt an, dass das Argument nach Verweis übergeben wird. ByRef ist die Standardeinstellung in Visual Basic.
ParamArray Optional. Wird lediglich als letztes Argument in arglist verwendet, um anzuzeigen, dass das letzte Argument ein Optional-Array von Variant-Elementen ist. Mit dem Schlüsselwort ParamArray können Sie eine beliebige Anzahl von Argumenten bereitstellen. Es darf jedoch nicht zusammen mit ByVal, ByRef oder Optional verwendet werden.
varname Erforderlich. Name der Variable, die das Argument darstellt; folgt den Standardbenennungskonventionen für Variablen.
type Optional. Datentyp des Arguments, das an die Prozedur übergeben wird; kann Byte, Boolean, Integer, Long, Currency, Single, Double, Decimal (derzeit nicht unterstützt), Date, String (nur mit variabler Länge), Object, Variante oder ein spezifischer Objekttyp sein. Wenn der Parameter nicht Optional lautet, kann auch ein benutzerdefinierter Typ angegeben werden.
defaultvalue Optional. Eine beliebige Konstante oder ein Konstantenausdruck. Gilt nur für den Parameter Optional. Wenn der Typ Object ist, kann ein expliziter Standardwert nur Nothing lauten.

HinwBemerkungeneise

Wenn nicht mithilfe von Public, Private oder Friend explizit angegeben, sind Property-Prozduren standardmäßig öffentlich. Wenn Static nicht verwendet wird, wird der Wert der lokalen Variablen zwischen Aufrufen nicht beibehalten.

Das Schlüsselwort Friend kann nur in Klassenmodulen verwendet werden. Auf Friend-Prozeduren kann jedoch durch Prozeduren in jedem beliebigen Modul eines Projekts zugegriffen werden. Eine Friend-Prozedur wird weder in der Typbibliothek ihrer übergeordneten Klasse angezeigt noch kann eine Friend-Prozedur spät gebunden werden.

Der gesamte ausführbare Code muss in Prozeduren enthalten sein. Sie können keine Property Get-Prozedur innerhalb einer anderen Property-, Sub- oder Function-Prozedur definieren.

Die Exit Property-Anweisung bewirkt ein sofortiges Beenden einer Property Get-Prozedur . Die Ausführung des Programms wird mit der Anweisung fortgesetzt, die auf die Anweisung folgt, von der die Property Get-Prozedur aufgerufen wurde. Exit Property-Anweisungen können beliebig oft an beliebigen Stellen in einer Property Get-Prozedur auftreten.

Wie die Sub - oder Property Let -Prozedur ist auch die Property Get -Prozedur eine eigenständige Prozedur, die Argumente erhalten, eine Reihe von Anweisungen ausführen und die Werte ihrer Argumente ändern kann. Im Gegensatz zu einer Sub - oder Property Let-Prozedur können Sie eine Property Get-Prozedur auf der rechten Seite eines Ausdrucks auf die gleiche Weise verwenden, wie Sie eine Funktion oder einen Eigenschaftsnamen verwenden, wenn Sie den Wert einer Eigenschaft zurückgeben möchten.

Beispiel

In diesem Beispiel wird mit der Property Get -Anweisung eine Eigenschaftenprozedur definiert, die den Wert einer Eigenschaft abruft. Die Eigenschaft identifiziert die aktuelle Farbe eines Stifts als Zeichenfolge.

Dim CurrentColor As Integer 
Const BLACK = 0, RED = 1, GREEN = 2, BLUE = 3 
 
' Returns the current color of the pen as a string. 
Property Get PenColor() As String 
 Select Case CurrentColor 
 Case RED 
 PenColor = "Red" 
 Case GREEN 
 PenColor = "Green" 
 Case BLUE 
 PenColor = "Blue" 
 End Select 
End Property 
 
' The following code gets the color of the pen 
' calling the Property Get procedure. 
ColorName = PenColor 

Siehe auch

Support und Feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.