QuickScript .NET 变量
- Last UpdatedApr 24, 2026
- 1 minute read
在 QuickScript .NET 脚本中使用 QuickScript .NET 变量之前，请先对这些变量进行声明。变量用在语句和表达式的左侧、右侧均可。
本地变量或属性可在相同的脚本中一起使用。在脚本正文中声明的变量将在脚本执行后失去其值。在脚本正文中声明的变量其它脚本无法访问。
在声明区域中声明的变量会在脚本关联的对象的整个生命周期内保留其值。
通过单独的 DIM 语句（后跟分号）声明脚本中的每个变量。在脚本选项卡页面的声明区域中输入 DIM 语句。DIM 语句的上下文如下：
DIM <variable_name> [ ( <upper_bound>
[, <upper_bound >[, < upper_bound >]] ) ]
[ AS <data_type> ];
其中：
|
DIM |
要求的关键字。 |
|
<variable_name> |
以字母（A-Z 或 a-z）开头的名称，其余字符可以是字母（A-Z 或 a-z）、数字 (0-9) 以及下划线 (_) 的任意组合。变量名限制不超过 255 个 Unicode 字符。 |
|
<upper_bound> |
引用数组维的向上绑定（1 到 2,147,483,647 之间的数字，含 1 和 2,147,483,647）。DIM 语句中支持三个维，每个维都嵌套在语法结构中。在指定了向上绑定之后，声明后即固定。不支持类似于 Visual Basic 的 ReDim 的语句。 每个数组维的向下绑定始终是 1。 |
|
AS |
用于声明变量数据类型的可选关键字。 |
|
<data_type> |
以下 11 种数据类型中的任意一种：布尔型、离散、整型、经过时间、浮点、实型、双精度、字符串型、消息、时间或对象。 |
变量名与属性名相反，不能包含句点。变量名和数据类型标识不区分大小写。如果脚本中的声明变量和其它命名实体有命名冲突（例如，脚本利用的属性名、别名或对象名称），则变量名比其它命名实体优先。如果变量名与别名相同，则会在验证脚本时显示警告消息，表明忽略别名。
用于指定整个数组的语法是“[]”，对本地数组变量和属性引用都是如此。例如，要将属性数组分配给本地数组，语法为：
locarr[] = tag.attr[];
DIM 语句可以位于脚本正文中的任意位置，但必须位于第一个引用脚本语句或表达式之前。如果在 DIM 语句之前引用了本地变量，则在保存包含脚本的对象时执行的脚本验证会提示您定义该语句。
只有在保存包含脚本的对象时才会发生上述验证。这与选择验证脚本按钮时执行的脚本语法验证不同。
请勿层叠 DIM 语句。例如，下列示例无效：
DIM LocVar1 AS Integer, LocVar2 AS Real;
DIM LocVar3, LocVar4, LocVar5, AS Message;
要声明多个变量，请为每个变量输入单独的 DIM 语句。
当用在等式右侧时，声明的本地变量会始终让左侧的表达式质量为“Good”。例如：
dim x as integer;
dim y as integer;
x = 5;
y = 5;
me.attr = 5;
me.attr = x;
me.attr = x+y;
在每个 me.attr 案例中，质量都是“Good”。
当在运算符右侧的表达式中使用变量时，其质量会被视为“Good”，以便于数据质量传播。
可以使用空来表示当前没有为变量分配对象。使用空的意思跟 C# 中的关键字“null”或 Visual Basic 中的关键字“nothing”相同。为变量分配空使变量可以被垃圾收集处理。您可能不会使用值为空的变量。如果要使用，则脚本终止，记录器中会显示错误消息。但可以测试变量是否为空。示例：
IF myvar == null THEN ...
对于系统对象，不能将属性作为参数传递。如果要解决此问题，请使用本地变量作为中间值，或者明示在调用系统对象时使用适当的函数调用将属性转换为字符串。