大网数据广告活动
.NET 与 C# 开发

已声明的元素名称 (Visual Basic)

· 52CE 我爱测

每个已声明的元素有一个名称,也称为*标识符*,这是代码使用来对其进行引用。

每个已声明的元素有一个名称,也称为标识符,这是代码使用来对其进行引用。

规则

在 Visual Basic 中的元素名称必须遵守以下规则:

  • 它必须以字母字符或下划线开头 (_)。

  • 它必须仅包含字母字符、 十进制数字和下划线。

  • 如果以下划线开头,它必须包含至少一个字母字符或十进制数。

  • 它不能超过 1023年个字符。

1023 个字符的长度限制也适用于整个字符串的完全限定的名称,例如outerNamespace.middleNamespace.innerNamespace.thisClass.thisElement。

下面的示例显示了一些有效的元素名称。

aB123__45

_567

下面的示例演示一些无效的元素名称。 第一个仅包含一个下划线、 十进制数字,以开始第二个和第三个包含无效字符 ($)。

' Three INVALID element names

_

12ABC

xyz$wv

Caution: 以下划线开头的元素名称 (_) 不属于语言独立性和与语言无关的组件(CLS),因此符合 cls 的代码不能使用一个组件,它定义此类名称。 但是,在中任何其他位置中的元素名称以下划线是符合 CLS 規格。

名称长度准则

在实践中,你的名称应尽可能短时仍然能够清楚地标识元素的特性。 这可提高你的代码的可读性,并减少行长度和源文件大小。

但是,你的名称不应太短,它不会不充分描述该元素表示和你的代码如何使用它。 这一点对于提高代码的可读性。 如果其他人正在尝试理解它,或者如果您自己正在寻求通过它您在编写之后很长时间,合适的元素名称可以节省相当长的时间。

转义的名称

通常情况下,元素名称必须与任何不匹配的 Visual Basic 中,如保留的关键字Case或Friend。 但是,可以定义转义名称,这括在方括号 ([ ])。 转义的名称可以与匹配任何 Visual Basic 关键字,因为括号消除不明确性。 在引用名称在代码中更高版本时,还可以使用括号。

一般情况下,应使用转义后名称时,才:

  • 从以前版本的 Visual Basic 的没有保留关键字用作名称; 迁移你的代码或

  • 您正在使用中则不保留给定的关键字的另一种语言编写的代码。

否则,应考虑重命名该元素,如果其名称与关键字冲突。 集成的开发环境 (IDE) 提供了执行此操作的简单办法。 有关详细信息,请参阅重构。

在名称中区分大小写

在 Visual Basic 中的元素名称不区分大小写。 这意味着当编译器在比较两个不同的字母大小写的名称,将它们解释为相同的名称。 例如,它认为 ABC 和 abc 指的是同一个声明的元素。

但是,公共语言运行时 (CLR) 使用区分大小写的绑定。 因此,当你生成程序集或 DLL 并使其可供其他程序集使用时,则名称将不再不区分大小写。 例如,如果你用名为 ABC的元素定义类,而其他程序集通过公共语言运行时使用你的类,则元素必须指的是 ABC。 如果以后要重新编译您的类并将该元素的名称改为abc,使用你的类的其他程序集将无法再访问该元素。 因此,发布程序集的更新版本时,不应该更改公共元素的字母大小写。

名称和区域设置

比较的名称是独立于区域设置。 如果两个名称匹配在一个区域设置中,可确保在所有区域设置匹配。

请参阅

历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / .NET 中文文档历史快照
适用范围
历史中文快照 2019-08-18;详见原文产品版本;文档日期 07/20/2015
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。