《Visual Basic .NET 语言参考》

【实例截图】

【核心代码】

Contents
Visual Basic 指南
Visual Basic 的新增功能
编译器中的重大更改
开始操作
为 Visual Basic 程序员提供的附加资源
开发应用程序
Visual Basic 编程
访问计算机资源
记录来自应用程序的信息
访问用户数据
访问应用程序窗体
访问应用程序 Web 服务
如何：以异步方式调用 Web 服务
访问应用程序设置
处理驱动器、目录和文件
使用 My 开发
使用 My.Application 、 My.Computer 和 My.User 执行任务
My.Forms 和 My.WebServices 提供的默认对象实例
使用 My.Resources 和 My.Settings 快速开发应用程序
Visual Basic 应用程序模型概述
My 对项目类型的依赖方式
访问数据
创建和使用组件
Windows 窗体应用程序基础知识
利用 Visual Basic 自定义项目并扩展 My 对象
扩展 My 命名空间
打包和部署自定义 My 扩展
扩展 Visual Basic 应用程序模型
自定义 My 中可用的对象
 编程概念
使用 Async 和 Await 的异步编程
特性
调用方信息
集合
协变和逆变
表达式树
迭代器
语言集成查询 (LINQ)
面向对象的编程
反射
序列化
程序结构和代码约定
程序结构
主要过程
引用和 Imports 语句
命名空间
命名约定
编码约定
条件编译
如何：在代码中拆分和合并语句
如何：折叠和隐藏代码节
如何：标记语句
代码中的特殊字符
代码中的注释
代码中用作元素名称的关键字
Me 、 My 、 MyBase 和 MyClass
限制
语言功能
数组
集合初始值设定项
常量和枚举
 控制流
数据类型
类型字符
基本数据类型
数值数据类型
字符数据类型
杂项数据类型
复合数据类型
如何：在一个变量中保留多个值
泛型类型
定义可对不同类型提供相同功能的类
使用泛型类
泛型过程
可以为 null 的值类型
Value Types and Reference Types
类型转换
Widening and Narrowing Conversions
隐式转换和显式转换
字符串和其他类型之间的转换
如何：将一个对象转换为其他类型
数组转换
结构
如何：声明结构
结构变量
结构和其他编程元素
结构和类
元组
有效使用数据类型
数据类型疑难解答
已声明的元素
委托
早期绑定和后期绑定
 错误类型
事件
接口
演练：创建和实现接口
LINQ
对象和类
运算符和表达式
过程
语句
字符串
变量
XML
COM 互操作
COM 互操作介绍
如何：引用 COM 对象
如何：使用 ActiveX 控件
演练：调用 Windows API
如何：调用 Windows API
如何：调用需要使用无符号类型的 Windows 函数
演练：创建 COM 对象
互操作性疑难解答
.NET Framework 应用程序中的 COM 互操作性
演练：使用 COM 对象实现继承
语言参考
配置语言版本
版式和代码约定
Visual Basic 运行库成员
关键字
数组摘要
集合对象摘要
控制流摘要
转换摘要
 Data Types Summary
日期和时间摘要
声明和常量摘要
目录和文件摘要
错误摘要
财务摘要
信息和交互摘要
输入和输出摘要
数学摘要
派生的数学函数
My 引用
运算符摘要
注册表摘要
字符串操作摘要
特性
常量和枚举
数据类型摘要
布尔数据类型
Byte 数据类型
Char 数据类型
Date 数据类型
Decimal 数据类型
Double 数据类型
Integer 数据类型
Long 数据类型
Object Data Type
SByte 数据类型
Short 数据类型
Single 数据类型
String 数据类型
UInteger 数据类型
ULong 数据类型
 用户定义的数据类型
UShort 数据类型
指令
#Const
#ExternalSource
#If...Then...#Else
# 区域
#Disable 和 #Enable
函数
转换函数
数学函数
字符串函数
Type Conversion Functions
返回 CStr 函数的值
CType Function
修饰符
Ansi
Assembly
Async
自动
RemoveHandler
ByVal
默认
Friend
In （泛型修饰符）
迭代器
键
模块
MustInherit
New
Narrowing
NotInheritable
 NotOverridable
可选
Out （泛型修饰符）
Overloads
Overrides
Overrides
ParamArray
部分
Private
Private Protected
Protected
Protected Friend
Public
ReadOnly
Shadows
Shared
Static
Unicode
Widening
WithEvents
WriteOnly
模块
Nothing
对象
My.Application 对象
My.Application.Info 对象
My.Application.Log 对象
My.Computer 对象
My.Computer.Audio 对象
My.Computer.Clipboard 对象
My.Computer.Clock 对象
My.Computer.FileSystem 对象
 My.Computer.FileSystem.SpecialDirectories 对象
My.Computer.Info 对象
My.Computer.Keyboard 对象
My.Computer.Mouse 对象
My.Computer.Network 对象
My.Computer.Ports 对象
My.Computer.Registry 对象
My.Forms 对象
My.Log 对象
My.Request 对象
My.Response 对象
My.Resources 对象
My.Settings 对象
My.User 对象
My.WebServices 对象
TextFieldParser Object
运算符
运算符优先级
运算符结果的数据类型
按功能列出的运算符
算术运算符
赋值运算符
移位运算符
比较运算符
串联运算符
逻辑 - 位运算符
其他运算符
Visual Basic 运算符列表
& 运算符
&= 运算符
* 运算符
*= 运算符
  运算符
= 运算符
= 运算符
- 运算符
-= 运算符
< 运算符
<= 运算符
> 运算符
>= 运算符
<< 运算符
<<= 运算符
>> 运算符
>>= 运算符
/ 运算符
/= 运算符
\ 运算符
\= 运算符
^ 运算符
^= 运算符
?() 运算符
?. 运算符
AddressOf 运算符
And 运算符
AndAlso 运算符
Await 运算符
DirectCast 运算符
函数表达式
GetType Operator
GetXmlNamespace 运算符
If 运算符
Is 运算符
IsFalse 运算符
 IsNot 运算符
IsTrue 运算符
Like 运算符
Mod 运算符
NameOf 运算符
New 运算符
Not 运算符
Or 运算符
OrElse 运算符
Sub 表达式
TryCast 运算符
TypeOf 运算符
Xor 运算符
属性
查询
Aggregate Clause
Distinct 子句
Equals 子句
From 子句
Group By 子句
Group Join 子句
Join 子句
Let 子句
Order By 子句
Select 子句
Skip 子句
Skip While 子句
Take 子句
Take While 子句
Where 子句
语句
A-E 语句
 AddHandler 语句
Call 语句
Class 语句
Const 语句
Continue 语句
Declare Statement
Delegate 语句
Dim 语句
Do...Loop 语句
Else 语句
End 语句
End <keyword> 语句
Enum 语句
Erase 语句
Error 语句
Event 语句
Exit 语句
F-P 语句
For Each...Next 语句
For...Next 语句
Function 语句
Get 语句
GoTo 语句
If...Then...Else 语句
Implements 语句
Imports 语句（ .NET 命名空间和类型）
Imports 语句（ XML 命名空间）
Inherits Statement
Interface 语句
Mid 语句
Module 语句
Namespace 语句
 On Error 语句
Operator Statement
Option <keyword> 语句
Option Compare 语句
Option Explicit 语句
Option Infer 语句
Option Strict Statement
Property Statement
Q-Z 语句
RaiseEvent 语句
ReDim 语句
REM 语句
RemoveHandler 语句
Resume 语句
Return 语句
Select...Case 语句
Set 语句
Stop 语句
Structure 语句
Sub 语句
SyncLock 语句
Then 语句
Throw 语句
Try...Catch...Finally 语句
Using 语句
While...End While 语句
With...End With 语句
Yield 语句
子句
Alias 子句
As 子句
Handles 子句
 Implements 子句
In 子句
Into 子句
Of 子句
声明上下文和默认访问级别
特性列表
参数列表
Type List
XML 注释标记
<c>
<code>
<example>
<exception>
<include>
<list>
<para>
<param>
<paramref>
<permission>
<remarks>
<returns>
<see>
<seealso>
<summary>
<typeparam>
<value>
XML 轴属性
XML Attribute Axis Property
XML Child Axis Property
XML Descendant Axis Property
扩展索引器属性
XML 值属性
 XML 文本
XML 元素文本
XML 文档文本
XML CDATA 文本
XML 注释文本
XML 处理指令文本
错误消息
概述
BC30663
BC32500
“#ElseIf” 前面必须是匹配的 “#If” 或 “#ElseIf”
“#Region” 和 “#End Region” 语句在方法体 / 多行 lambda 内无效
“<classname>” 不符合 CLS ，因为它所实现的接口 “<interfacename>” 不符合 CLS
“<elementname>” 已过时（ Visual Basic 警告）
“<eventname>” 是事件，不能直接调用
“<expression>” 不能用作类型约束
未声明 “<functionname>” （智能设备 -Visual Basic 编译器错误）
“<interfacename>.<membername>” 已经由基类 “<baseclassname>” 实现。 假定重新
实现 <type>
“<keyword>” 只在实例方法中有效
“<membername>” 不能通过 <typename>“<containertype>” 在项目外部公开类
型 “<containertypename>”
“<membername>” 在继承接口 “<interfacename1>” 和 “<interfacename2>” 之间不明
确
<message> 此错误也可能是由于将程序集 “<assemblyname>” 的文件引用与项目引用
混合使用所造成的
“<methodname>” 具有多个带有相同签名的定义
“<name>” 在命名空间 “<namespacename>” 中不明确
“<name1>” 不明确，从命名空间或类型 “<name2>” 导入
<proceduresignature1> 不符合 CLS ，因为它重载仅在数组参数类型的数组或数组参
数类型的秩方面与它不同的 <proceduresignature2>
<type1>“<typename>” 必须为接口 “<interfacename>” 实现 “<membername>”
<type1>“<typename>” 必须为接口 “<interfacename>” 实现 “<methodname>”
“<typename>” 将对基 <type> 的访问扩展到程序集的外部，因此无法从
<basetypename>“<type>” 继承
“<typename>” 是委托类型
“<typename>” 是一个类型，不能用作表达式
如果将 EscapeQuote 设置为 True ，则双引号不是分隔字段的有效注释标记
无论是作为参数还是作为返回值，属性或方法调用都不能包括对私有对象的引用
创建了对嵌入的互操作程序集 “<assembly1>” 的引用，因为程序集 “<assembly2>” 间接
引用了该程序集
未指定启动窗体
通过实例访问共享成员；将不计算限定表达式
“AddressOf” 操作数必须是方法名（不带括号）
发生错误，因为无法获得单个实例启动所需的操作系统资源
只能从不带自变量的简单名或限定名中推断匿名类型成员名称
自变量不可选
数组界限不能出现在类型说明符中
声明为 For Each 循环控制变量的数组在声明时不能指定初始大小值
缺少数组下标表达式
声明为结构成员的数组不能用初始大小声明
“Declare” 语句中不支持 “As Any”
自动错误
错误的校验和值、非十六进制数字或奇数个十六进制数字
错误的 DLL 调用约定
错误的文件模式
错误的文件名或文件号
错误的记录长度
在调用完成之前，会继续执行当前方法，原因是此调用不处于等待状态
无法将匿名类型转换为表达式树，因为此类型的属性用于初始化其他属性
无法创建 ActiveX 组件
“<name>” 是使用 “System.MarshalByRefObject” 作为基类的类 “<name>” 的值类型字
段 “<classname>” 的成员，无法引用
没有类的显式实例，就无法从共享方法或共享成员初始值设定项中引用该类的实例成
员
无法建立必要的临时文件。
无法打开 “<filename>” 进行写入
 无法找到类 “<classname>”
类不支持自动化或不支持所需的接口
“Class” 语句必须以匹配的 “End Class” 结束
剪贴板格式无效
常量表达式无法在类型 “<typename>” 中表示
常量必须是内部类型或者枚举类型，不能是类、结构、类型参数或数组类型
构造函数 “<name>” 不能调用自身
将 “ByRef” 参数 “<parametername>” 的值复制回匹配的参数将导致从类
型 “<typename1>” 到类型 “<typename2>” 的收缩转换
“Custom” 修饰符在未用显式委托类型声明的事件上无效
无法根据这些实参推断类型形参的数据类型
需要声明
默认属性 “<propertyname1>” 与 “<propertyname2>” 中的默认属性 “<classname>” 冲
突，因此应声明为 “Shadows”
默认属性访问在接口 “<defaultpropertyname>” 的继承接口成
员 “<interfacename1>” 和接口 “<defaultpropertyname>” 的 “<interfacename2>” 之间不
明确
委托类 “<classname>” 没有 Invoke 方法，所以此类型的表达式不能作为方法调用的目
标
派生类无法引发基类事件
设备 I/O 错误
必须首先用一个 “PathName” 自变量调用 “Dir” 函数
需要语句结束
创建程序集清单时出错： <error message>
创建 Win32 资源时出错： <error message>
加载 DLL 时出错
在保存临时的 Win32 资源文件 “<filename>” 时出错： <error message>
编译项目中的 XML 架构时发生错误
表达式或语句的计算已超时
事件 “<eventname1>” 无法实现接口 “<eventname2>” 上的事件 “<interface>” ，因为它
们的委托类型 “<delegate1>” 和 “<delegate2>” 不匹配
事件不能用具有返回类型的委托类型声明
共享 WithEvents 变量的事件不能由非共享方法处理
表达式不产生值
 表达式的类型为 “<typename>” ，这是受限类型，不能用于访问
从 “Object” 或 “ValueType” 继承的成员
表达式是一个值，因此不能作为赋值目标
类型 <type> 的表达式不可查询
表达式递归调用包含属性 “<propertyname>”
表达式过于复杂
“Extension” 特性只能应用于 “Module” 、 “Sub” 或 “Function” 声明。
文件已打开
文件太大，无法读取到字节数组中
自动化操作期间找不到文件名或类名
找不到文件（ Visual Basic 运行时错误）
二元 “If” 表达式中的第一个操作数必须是可以为 null 的类型或引用类型
该 “Sub New” 的第一个语句必须是对 “MyBase.New” 或 “MyClass.New” 的调用（没有不
带参数的可访问构造函数）
此 “Sub New” 的第一条语句必须是对 “MyBase.New” 或 “MyClass.New” 的显式调用，因
为 “<constructorname>” 的基类 “<baseclassname>” 中的 “<derivedclassname>” 被标记
为已过时： “<errormessage>”
类型 “<typename>” 的 “For Each” 不明确，因为此类型实现
了 “System.Collections.Generic.IEnumerable(Of T)” 的多个实例化
友元程序集引用 <reference> 无效
函数 “<procedurename>” 并非在所有代码路径上都返回值
已禁用函数求值，因为前一个函数求值超时
用作可选参数类型的泛型参数必须受类约束
属性 “<propertyname>” 的 “Get” 访问器不可访问
Handles 子句需要在包含类型或它的基类型之一中定义的 WithEvents 变量
应输入标识符
标识符太长
应为初始值设定项
输入超出文件尾
在 <location> 处发生的内部错误
将 “ByRef” 参数 “<typename1>” 的值复制回匹配参数时，发生
从 “<typename2>” 到 “<parametername>” 的隐式转换。
“Is” 要求具有引用类型的操作数，但此操作数的值类型为 “<typename>” 。
类型 “typename” 的操作数 “IsNot” 只能与 “Nothing” 比较，因为 “typename” 是一个可以
为 null 的类型
数字标签后面必须跟冒号
将不会从此事件处理程序中移除 Lambda 表达式
Lambda 表达式在 “Select Case” 语句的第一个表达式中无效
后期绑定解决方案；可能会发生运行时错误
后期绑定重载决策不能应用于 “<procedurename>” ，因为访问实例是一个接口类型
前导 “.” 或 “!” 只能出现在 “With” 语句内
行太长
不再支持 “Line” 语句（ Visual Basic 编译器错误）
方法没有与委托兼容的签名
“System.Nullable(Of T)” 的方法不能用作 “AddressOf” 运算符的操作数
“Module” 语句只能出现在文件级或命名空间级
名称 <membername> 不符合 CLS
名称 “<name>” 未声明
根命名空间 <namespacename> 中的名称 <fullnamespacename> 不符合 CLS
Imports“<qualifiedelementname>” 中指定的命名空间或类型不包含任何公共成员，或
者找不到该命名空间或类型
在项目级 Imports“<qualifiedelementname>” 中指定的命名空间或类型不包含任何公
共成员，或者找不到该命名空间或类型
需要属性数组索引
嵌套函数没有与委托 “<delegatename>” 兼容的签名。
在 “<name>” 中找不到任何具有合适签名的可访问 “Main” 方法
在符合 CLS 的接口中不允许出现不符合 CLS 的 <membername>
该上下文中不支持可以为 null 的类型推理
索引数超过索引数组的维数
对象或类不支持事件集
需要对象
未设置对象变量或 With 块变量
运算符声明必须是以下符号之一： 、 - 、 * 、 - 、 - 、 ^ 、 & 、 Like 、 Mod 、 And 、 Or 、 Xor 、
Not 、 << 、 >> 、 = 、 <> 、 < 、 <= 、 > 、 >= 、 CType 、 IsTrue 、 IsFalse
需要 “Optional”
可选参数必须指定默认值
序号无效
 内存不足（ Visual Basic 编译器错误）
堆栈空间不足
字符串空间不足
溢出（ Visual Basic 错误）
溢出（ Visual Basic 运行时错误）
找不到路径
路径 / 文件访问错误
权限被拒绝
过程调用或参数无效
属性 “<propertyname>” 并非在所有代码路径上都返回值
属性数组索引无效
未定义 Property Let 过程，并且 Property Get 过程未返回对象
找不到属性
未找到属性或方法
范围变量 <variable> 隐藏封闭块中的变量、以前定义的范围变量或在查询表达式中隐
式声明的变量
只能根据不带自变量的简单名称或限定名称推断范围变量名称
需要引用包含类型 “<assemblyidentity>” 的程序集 “<typename>” ，但由于项
目 “<projectname1>” 和 “<projectname2>” 之间存在二义性，未能找到合适的引用
需要对程序集 “<assemblyname>” （包含基类 “<classname>” ）的引用
请求的操作不可用 (BC35000)
无错误继续执行
函数 “<procedurename>” 的返回类型不符合 CLS
属性 “<propertyname>” 的 “Set” 访问器不可访问
无法删除某些子项
语句不能在 “If” 语句行之外结束块
语句在命名空间中无效
语句在方法 / 多行 lambda 内无效
字符串常量必须以双引号结束
结构 “<structurename>” 至少必须包含一个实例成员变量或至少必须包含一个未标记
为 “Custom” 的实例事件声明
在 “<name>” 中未找到 “Sub Main”
未定义 Sub 或 Function
 下标超出范围
TextFieldParser 无法完成读取操作，因为已经超出最大缓冲区大小
无法推断出变量 “<variablename>” 的类型，因为它绑定到封闭范围中的某个字段
此数组是固定数组或被临时锁定
此关键字已与该集合的某个元素相关联
文件太多
类型 “<typename>” 没有构造函数
类型 <typename> 不符合 CLS
未定义类型 “<typename>”
未能从委托中推理类型参数
类型不匹配
无法推断 “<variablename>” 的类型，因为循环边界和步骤变量未扩大到同一类型
成员 “<membername>” 的类型不符合 CLS
可选参数 <parametername> 的可选值的类型不符合 CLS
参数 “<parametername>” 的类型不符合 CLS
类型参数不能用作限定符
无法从密钥文件 “<filename>” 创建具有强名称的程序集： <error>
无法嵌入资源文件 “<filename>” ： <error message>
无法发出程序集： <error message>
无法找到所需的文件 “<filename>”
由于内部系统错误，无法获得串行端口名称
无法链接到资源文件 “<filename>” ： <error message>
无法加载类 “<classname>” 的信息
无法将输出写入内存
临时路径不可用，因此无法写入临时文件
无法写入输出文件 “<filename>” ： <error>
枚举的基础类型 <typename> 不符合 CLS
在 lambda 表达式中使用迭代变量可能会产生意外的结果
类型 “<typename1>” 的值无法转换为 “<typename2>”
类型 “<typename1>” 的值无法转换为 “<typename2>” （多个文件引用）
类型 “type1” 的值无法转换为 “type2”
变量 “<variablename>” 在封闭块中隐藏变量
 变量 “<variablename>” 在赋值前被使用
变量使用了 Visual Basic 不支持的自动化类型
XML 轴属性不支持后期绑定
XML 注释异常必须具有 “cref” 特性
不支持 XML 实体引用
ASP.NET 中的嵌入式代码不支持 XML 文本和 XML 属性
XML 命名空间 URI“<uri>” 可只绑定到 “xmlns”
参考
命令行编译器
从命令行生成
如何：调用命令行编译器
示例编译命令行
按字母顺序列出的编译器选项
@ （指定响应文件）
-addmodule
-baseaddress
-bugreport
-codepage
-debug
-define
-delaysign
-deterministic
-doc
-errorreport
-filealign
-help ，
-?
-highentropyva
-imports
-keycontainer
-keyfile
-langversion
-libpath
 -link
-linkresource
-main
-moduleassemblyname
-netcf
-noconfig
-nologo
-nostdlib
-nowarn
-nowin32manifest
-optimize
-optioncompare
-optionexplicit
-optioninfer
-optionstrict
-out
-platform
-quiet
-recurse
-reference
-refonly
-refout
-removeintchecks
-resource
-rootnamespace
-sdkpath
-target
-subsystemversion
-utf8output
-vbruntime
-verbose
-warnaserror
 -win32icon
-win32manifest
-win32resource
按类别列出的编译器选项
.NET Framework 参考信息
语言规范
示例应用程序
演练