Property Get-AnweisungProperty Get statement

Deklariert den Namen, die Argumenteund den Code, die den Textkörper einer Property- Prozedurbilden, die den Wert einer Eigenschaftabruft.Declares the name, arguments, and code that form the body of a Property procedure, which gets the value of a property.

SyntaxSyntax

[ Public | private | Friend ] [ Statisch ] Eigenschaft Get Name [(Arglist)] [ Als Typ ][ Public | Private | Friend ] [ Static ] Property Getname [ (arglist) ] [ As type ]
[ statements ][ statements ]
[ name = expression ][ name = expression ]
[ Beenden-Eigenschaft ][ Exit Property ]
[ statements ][ statements ]
[ name = expression ][ name = expression ]
End PropertyEnd Property


Die Syntax der Property Get -Anweisung besteht aus folgenden Teilen:The Property Get statement syntax has these parts:

TeilPart BeschreibungDescription
PublicPublic Optional.Optional. Gibt an, dass auf die Property Get-Prozedur von allen anderen Prozeduren in allen Modulen zugegriffen werden kann.Indicates that the Property Get procedure is accessible to all other procedures in all modules. Wenn die Prozedur in einem Modul verwendet wird, das eine Option Private-Anweisung enthält, ist sie außerhalb des Projekts nicht zugänglich.If used in a module that contains an Option Private statement, the procedure is not available outside the project.
PrivatePrivate Optional.Optional. Gibt an, dass auf die Property Get-Prozedur nur von anderen Prozeduren in dem Modul zugegriffen werden kann, in dem sie deklariert wurde.Indicates that the Property Get procedure is accessible only to other procedures in the module where it is declared.
FriendFriend Optional.Optional. Wird nur in einem Klassenmodul verwendet.Used only in a class module. Gibt an, dass die Property Get-Prozedur im gesamten Projekt sichtbar ist, jedoch nicht für den Controller einer Objektinstanz.Indicates that the Property Get procedure is visible throughout the project, but not visible to a controller of an instance of an object.
StaticStatic Optional.Optional. Gibt an, dass die lokalen Variablen der Property Get- Prozedur zwischen Aufrufen beibehalten werden.Indicates that the Property Get procedure's local variables are preserved between calls. 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.The Static attribute doesn't affect variables that are declared outside the Property Get procedure, even if they are used in the procedure.
namename Erforderlich.Required. Name der Get- Prozedur für die Eigenschaft; folgt standardmäßigen Variablen Benennungskonventionen, mit dem Unterschied, dass der Name mit einer Property Let- oder PropertySet- Prozedur in demselben Modul identisch sein kann.Name of the Property Get procedure; follows standard variable naming conventions, except that the name can be the same as a Property Let or Property Set procedure in the same module.
arglistarglist Optional.Optional. Variablenliste mit den Argumenten, die an die Property Get-Prozedur bei ihrem Aufruf übergeben werden.List of variables representing arguments that are passed to the Property Get procedure when it is called. Mehrere Argumente werden durch Kommas getrennt.Multiple arguments are separated by commas. 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).The name and data type of each argument in a Property Get procedure must be the same as the corresponding argument in a Property Let procedure (if one exists).
typetype Optional.Optional. Der Datentyp des Werts, der von der Get- Prozedur der Eigenschaft zurückgegeben wird; kann Byte, Boolean, Integer, Long, Currency, Single, Double, Decimal (derzeit nicht unterstützt), Date, String (mit Ausnahme von fester Länge), Object sein. , Variant, benutzerdefinierter Typund Arrays.Data type of the value returned by the Property Get procedure; may be Byte, Boolean, Integer, Long, Currency, Single, Double, Decimal (not currently supported), Date, String (except fixed length), Object, Variant, user-defined type, and Arrays.

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 Wert definiert, der der Eigenschaft auf der rechten Seite zugewiesen ist. eines Ausdrucks.The return type of a Property Get procedure must be the same data type as the last (or sometimes the only) argument in a corresponding Property Let procedure (if one exists) that defines the value assigned to the property on the right side of an expression.
statementsstatements Optional.Optional. Eine Gruppe von Anweisungen, die in der Property Get-Prozedur ausgeführt werden sollen.Any group of statements to be executed within the body of the Property Get procedure.
expressionexpression Optional.Optional. Wert der Eigenschaft, die von der Prozedur zurückgegeben wird, die durch die Property Get-Anweisung definierten wurde.Value of the property returned by the procedure defined by the Property Get statement.

Die Syntax des arglist-Arguments besteht aus folgenden Teilen:The arglist argument has the following syntax and parts:

[ Optional ] [ ByVal | ByRef ] [ ParamArray ] varname [()] [ As Type ] [ = DefaultValue ][ Optional ] [ ByVal | ByRef ] [ ParamArray ] varname [ ( ) ] [ As type ] [ = defaultvalue ]


TeilPart BeschreibungDescription
OptionalOptional Optional.Optional. Gibt an, dass ein Argument nicht erforderlich ist.Indicates that an argument is not required. Wenn verwendet, müssen alle nachfolgenden Argumente in arglist optional sein und mithilfe des Schlüsselworts Optional deklariert werden.If used, all subsequent arguments in arglist must also be optional and declared by using the Optional keyword.
ByValByVal Optional.Optional. Gibt an, dass das Argument nach Wert übergeben wird.Indicates that the argument is passed by value.
ByRefByRef Optional.Optional. Gibt an, dass das Argument nach Verweis übergeben wird.Indicates that the argument is passed by reference. ByRef ist die Standardeinstellung in Visual Basic.ByRef is the default in Visual Basic.
ParamArrayParamArray Optional.Optional. Wird lediglich als letztes Argument in arglist verwendet, um anzuzeigen, dass das letzte Argument ein Optional-Array von Variant-Elementen ist.Used only as the last argument in arglist to indicate that the final argument is an Optional array of Variant elements. Mit dem Schlüsselwort ParamArray können Sie eine beliebige Anzahl von Argumenten bereitstellen.The ParamArray keyword allows you to provide an arbitrary number of arguments. Es darf jedoch nicht zusammen mit ByVal, ByRef oder Optional verwendet werden.It may not be used with ByVal, ByRef, or Optional.
varnamevarname Erforderlich.Required. Name der Variable, die das Argument darstellt; folgt den Standardbenennungskonventionen für Variablen.Name of the variable representing the argument; follows standard variable naming conventions.
typetype Optional.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.Data type of the argument passed to the procedure; may be Byte, Boolean, Integer, Long, Currency, Single, Double, Decimal (not currently supported), Date, String (variable length only), Object, Variant, or a specific object type. Wenn der Parameter nicht Optional lautet, kann auch ein benutzerdefinierter Typ angegeben werden.If the parameter is not Optional, a user-defined type may also be specified.
defaultvaluedefaultvalue Optional.Optional. Eine beliebige Konstante oder ein Konstantenausdruck.Any constant or constant expression. Gilt nur für den Parameter Optional.Valid for Optional parameters only. Wenn der Typ Object ist, kann ein expliziter Standardwert nur Nothing lauten.If the type is an Object, an explicit default value can only be Nothing.

HinweiseRemarks

Wenn nicht mithilfe von Public, Private oder Friend explizit angegeben, sind Property-Prozduren standardmäßig öffentlich.If not explicitly specified by using Public, Private, or Friend, Property procedures are public by default. Wenn static nicht verwendet wird, wird der Wert lokaler Variablen zwischen Aufrufen nicht beibehalten.If Static is not used, the value of local variables is not preserved between calls.

Das Friend -Schlüsselwort kann nur auf in Klassenmodulen verwendet werden.The Friend keyword can only be used in class modules. Auf Friend-Prozeduren kann jedoch durch Prozeduren in jedem beliebigen Modul eines Projekts zugegriffen werden.However, Friend procedures can be accessed by procedures in any module of a project. Eine Friend-Prozedur wird weder in der Typbibliothek ihrer übergeordneten Klasse angezeigt noch kann eine Friend-Prozedur spät gebunden werden.A Friend procedure doesn't appear in the type library of its parent class, nor can a Friend procedure be late bound.

Der gesamte ausführbare Code muss in Prozeduren enthalten sein.All executable code must be in procedures. Sie können eine Property Get- Prozedur nicht innerhalb einer anderen Property-, Sub-oder Function -Prozedur definieren.You can't define a Property Get procedure inside another Property, Sub, or Function procedure.

Die Exit Property- Anweisung bewirkt ein sofortiges Beenden einer Property Get- Prozedur.The Exit Property statement causes an immediate exit from a Property Get procedure. Die Ausführung des Programms wird mit der Anweisung fortgesetzt, die auf die Anweisung folgt, von der die Property Get-Prozedur aufgerufen wurde.Program execution continues with the statement following the statement that called the Property Get procedure. Exit Property-Anweisungen können beliebig oft an beliebigen Stellen in einer Property Get-Prozedur auftreten.Any number of Exit Property statements can appear anywhere in a Property Get procedure.

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.Like a Sub and Property Let procedure, a Property Get procedure is a separate procedure that can take arguments, perform a series of statements, and change the values of its arguments. 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 Eigenschaftennamen verwenden, wenn Sie den Wert einer Eigenschaft zurückgeben möchten.However, unlike a Sub or Property Let procedure, you can use a Property Get procedure on the right side of an expression in the same way that you use a Function or a property name when you want to return the value of a property.

BeispielExample

In diesem Beispiel wird mit der Property Get -Anweisung eine Eigenschaftenprozedur definiert, die den Wert einer Eigenschaft abruft.This example uses the Property Get statement to define a property procedure that gets the value of a property. Die Eigenschaft identifiziert die aktuelle Farbe eines Stifts als Zeichenfolge.The property identifies the current color of a pen as a string.

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 auchSee also

Support und FeedbackSupport and feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation?Have questions or feedback about Office VBA or this documentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.