Get 语句

Get声明用于检索属性值的属性过程。

语法

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

部件

注解

除非属性被标记WriteOnly，否则每个属性都必须有一个Get属性过程。 该过程 Get 用于返回属性的当前值。

当表达式请求属性的值时，Visual Basic 会自动调用属性 Get 的过程。

属性声明的正文只能包含 Property 语句和End Property语句之间的属性Get和Set过程。 它不能存储除这些过程以外的任何内容。 具体而言，它无法存储属性的当前值。 必须将此值存储在属性外部，因为如果将该值存储在任一属性过程中，则其他属性过程无法访问它。 通常的方法是在与属性相同的级别声明的 Private 变量中存储值。 必须定义 Get 它所应用到的属性内的过程。

该过程 Get 默认为其包含属性的访问级别，除非 accessmodifier 在语句中使用 Get 。

规则

• 混合访问级别。 如果要定义读写属性，可以选择为 Get 或 Set 过程指定不同的访问级别，但不能同时指定两者。 如果执行此作，过程访问级别必须比属性的访问级别更严格。 例如，如果声明Friend属性，则可以声明过程Private，但不能Public声明Get过程。

  如果要定义属性 ReadOnly ，该过程 Get 表示整个属性。 不能声明不同的访问级别 Get，因为这将为属性设置两个访问级别。

• 返回类型。 Property 语句可以声明它返回的值的数据类型。 该过程 Get 会自动返回该数据类型。 可以指定任何数据类型或枚举、结构、类或接口的名称。

  Property如果未指定returntype语句，该过程将Object返回。

行为

• 从过程返回。 Get当过程返回到调用代码时，执行将继续在请求属性值的语句中执行。

  Get 属性过程可以使用 Return 语句 或向属性名称分配返回值来返回值。 有关详细信息，请参阅 函数语句中的“返回值”。

  和Exit PropertyReturn语句导致立即退出属性过程。 任意数量的 Exit Property 语句 Return 都可以出现在过程中的任意位置，并且可以混合 Exit Property 和 Return 语句。

• 返回值。 若要从 Get 过程返回值，可以将该值赋给属性名称，或将其包含在 Return 语句中。 该 Return 语句同时分配 Get 过程返回值并退出过程。

  如果不 Exit Property 将值分配给属性名称，该过程 Get 将返回属性数据类型的默认值。 有关详细信息，请参阅 函数语句中的“返回值”。

  下面的示例演示了只读属性 quoteForTheDay 可以返回私有变量 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
  

示例：

以下示例使用 Get 语句返回属性的值。

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

另请参阅

• Set 语句
• 财产声明
• 退出语句
• 对象和类
• 演练：定义类