管理变量

在 Studio 中，变量用于存储多种类型的数据。变量的另一个关键之处在于它们的值可以改变以实现多种目的，例如控制循环主体的执行次数。

备注：

• 变量需要用不同的名称创建，即使在不同的范围中使用也不能名称相同。如果两个变量共享相同名称，但位于不同作用域中，则内部作用域中的变量优先。您可以查看我们的工作流设计命名约定建议。
• 变量名称必须以字母或下划线 _ 开头。
• 使用某些关键字（例如“替换”）来命名变量可能会导致意外错误。

从 Studio 的角度来看，变量的名称是其唯一 ID，它定义了变量的显示和使用方式。如果更改或删除，Studio 将无法根据加载的活动解释 .xaml 文件。必须在所有字符串两边加引号。

重要提示：如果“变量”和“参数”的名称相同，则变量始终默认为 ，并在运行时使用。

您可以通过多种方式管理变量。为了从最佳体验和灵活性中受益，我们建议使用数据管理器。

变量类型

存储在变量中的数据称为值，它可以是多种类型。创建变量时，可选择以下选项：

• 布尔值 - 此类型只有两个可能的值：true 或 false。这些变量使您能够做出决策，从而更好地控制工作流。
• Int32 - 此类型用于存储数字信息。它的一些用途是执行等式，比较和传递重要数据。
• 字符串 - 存储文本信息。此类变量可用于存储任何基于文本的信息，例如员工姓名、用户名或任何其他字符串。
• 对象 - 可用于存储不同类型的数据。在变量中存储的数据类型需要比较灵活时，可以使用这种类型的变量。请确保对象变量中使用的数据类型与使用此变量的活动兼容。
• System.Data.DataTable - 此类型可存储大量信息，并可充当数据库或包含行和列的简单电子表格。可用于将特定数据从一个数据库迁移到另一个数据库，从网站提取信息并将其以本地方式存储在电子表格，还可用于其他用途。
• [T] 数组 - 用于存储同一类型的多个值。

• 浏览类型 - 让您可以探索更多与您的任务相关的类型。

  注意：将项目中使用的语言定义的类型变量用作静态变量会导致 Windows 和跨平台项目中出现编译错误。

变量范围

作用域属性为变量提供了定义良好的上下文，可以在其中使用变量。作用域可以设置为全局（在整个项目中可用）、当前工作流文件或工作流文件中的任何容器活动。

您只能从 Data Manager 创建全局变量。

备注：

• 全局变量未序列化，因此与长时间运行的持久性活动不兼容。
• 库项目中不支持全局变量。

创建变量

从 Data Manager

1. 打开数据管理器，然后选择“新建”>“新建变量”。
2. 配置变量的名称、数据类型、作用域和默认值。

通过活动主体

1. 从“活动”面板中，将活动拖动到“设计器”面板。右键单击字段并从上下文菜单中选择“创建变量”，然后按 Ctrl+K，或从字段右侧的加号菜单 中选择“创建变量”。系统将显示“设置变量”字段。
2. 填写名称，然后按 Enter 键。变量已创建并在字段中可见。在“数据管理器”中检查变量的作用域和类型。

从表达式

另外，可以通过活动输入字段或“表达式编辑器”直接使用表达式创建变量：

1. 选择表达式的一部分，然后按 Ctrl+K。系统将显示“设置变量”字段。

2. 填写名称，然后按 Enter 键。系统即会创建此变量。在“数据管理器”中检查变量的作用域和类型。

   
   

   

   
   

以此方式创建的变量将根据活动自动接收相关类型。例如，如果在“写入范围”活动的 Data Table 字段中创建变量，则变量类型设置为 DataTable。如果在“写入行”活动的 Text 字段中创建变量，则变量类型设置为 String。

此类变量的作用域为其所属的最小容器。系统将根据所选属性自动生成变量类型。

通过属性面板

1. 在任何活动的“属性”面板中，右键单击字段并从上下文菜单中选择“创建变量”，然后按 Ctrl+K，或从字段右侧的加号菜单 中选择“创建变量”。系统将显示“设置变量”字段。
2. 填写名称，然后按 Enter 键。变量已创建并在字段中可见。在“数据管理器”中检查变量的作用域和类型。

以此方式创建的变量的作用域为其所属的最小容器。系统将根据所选属性自动生成类型。

通过变量面板

1. 在“设计器”面板中，单击“变量”。系统将显示“变量”面板。
2. 单击“创建变量”行，并填写名称。系统随即会创建新变量。

以此方式创建的变量的默认类型为“字符串”。

从活动输出中自动生成的变量（仅适用于 Windows 和跨平台项目）

如果启用了“自动生成活动输出”设计设置，Studio 会自动为生成输出的活动的每个“输出”字段填充变量。然后，您可以通过选择输入字段右侧的“+” 菜单，然后单击“使用变量”，在其他活动中使用生成的变量。

如果您更喜欢手动创建输出变量，可以在输出字段中执行此操作。这会将生成的变量替换为您创建的变量。如果在手动创建变量后选择“清除值”选项，则系统会还原默认生成的变量。

生成的变量位于“变量”面板和“数据管理器”中（如果该变量已在其他活动中使用）。与任何其他变量一样，您可以更改生成变量的名称、数据类型、作用域和默认值。

所生成变量的作用域取决于活动在工作流中的位置（例如，如果活动位于主序列或“遍历循环”活动中，则作用域会有所不同）。如果您复制、剪切或粘贴活动，则系统会更新生成的变量范围。重命名活动不会影响生成的变量。但是，删除活动则会造成以下结果：

• 如果变量未使用，则清除变量的值。
• 如果使用变量，并且在使用变量作为输入的活动中显示警告，则删除变量。

删除变量

您可以从“数据管理器”或“变量”面板中删除变量。

从 Data Manager

1. 打开“数据管理器”，然后展开“变量”节点。
2. 右键单击变量，然后选择“删除变量”。或者，将其选中，然后按 Delete 键。

通过变量面板

1. 打开“变量”面板。

2. 右键单击变量，然后选择“删除”。或者，将其选中，然后按 Delete 键。

   
   

   

   
   

删除未使用的变量

要删除已定义但当前文件中在任何位置均未使用的所有变量，请在 Studio 功能区中选择“删除未使用”>“变量”，然后在系统提示确认时选择“是”。此选项还将删除未使用但已在注释中提及的变量。

注意：如果删除或升级某个包可能导致变量或参数未定义，那么系统将在其位置添加一个“未知类型”，以便能够在 Studio 中打开和编辑该包。

浏览 .Net 变量类型

要搜索“变量类型”列表中默认情况下未显示的变量类型，请执行以下操作：

1. 在“数据管理器”中，从变量的“数据类型”下拉列表中，选择“浏览类型”。您还可以从“变量”面板的“变量类型”下拉列表中访问该菜单。系统将显示“浏览并选择 .Net 类型”窗口。
2. 在“类型名称”字段中，为要查找的变量键入关键字，如 Excel。注意，结果部分已经更新，显示包含您的关键字的所有 .Net 变量类型。

3. 选择一个，然后单击“确定”。系统将使用所选类型创建一个新变量并将其显示在“变量”面板中。

   
   

   

   
   
   注意：从“浏览并选择 .Net 类型”窗口选择一种变量类型之后，该变量将显示在“变量”面板中的“变量类型”下拉列表中。

Studio 或机器人专属程序集所含的变量和参数类型为隐藏状态。引用了此类程序集中的类型的工作流不应在运行时受到影响。若要使用非 .Net Framework 程序集所含的类型，请通过“管理包”窗口将其添加为项目的依赖项。

注意：将浮点数文本（例如 10.5）分配给浮点类型 (System.Single) 的变量或参数会导致运行工作流时出现编译错误。要成功分配值，您可以执行以下操作：

• 使用 f 或 F 后缀（1.5f 或 1.5F）
• 使用强制转换运算符（对于 C#，使用 (float)1.5；对于 VB，使用 CSng(1.5)）