管理变量

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

备注：

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

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

重要提示：

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

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

变量类型

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

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

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

  变量范围

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

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

备注：

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

创建变量

从 Data Manager

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

通过活动主体

1. From the Activities panel, drag an activity to the Designer panel. Either right-click a field and select Create Variable from the context menu, press Ctrl+K, or select Create Variable from the Plus menu on the right side of the field. The Set Var field is displayed.

2. 填写名称，然后按 Enter 键。变量已创建并在字段中可见。在“数据管理器”中检查变量的作用域和类型。

从表达式

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

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

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

   

通过这两种方式创建的变量会自动根据活动接收类型。 例如，如果您在写入范围活动的Data Table字段中创建变量，则变量的类型将设置为 DataTable。 如果您在写入行活动的Text字段中创建变量，则变量的类型将设置为 String。

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

通过属性面板

1. In the Properties panel of any activity, either right-click a field and select Create Variable from the context menu, press Ctrl+K, or select Create Variable from the Plus menu on the right side of the field. The Set Var field is displayed.

2. 填写名称，然后按 Enter 键。变量已创建并在字段中可见。在“数据管理器”中检查变量的作用域和类型。

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

通过变量面板

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

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

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

If the Auto-generate Activity Outputs design setting is enabled, Studio automatically populates each Output field of activities that generate an output with a variable. You can then use the generated variable in other activities by selecting the Plus menu on the right side of the activity input fields and then Use Variable.

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

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

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

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

删除变量

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

从 Data Manager

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

通过变量面板

1. 打开“变量”面板。

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

   

删除未使用的变量

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

备注：

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

浏览 .Net 变量类型

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

1. 在“数据管理器”中，从变量的“数据类型”下拉列表中，选择“浏览类型”。您还可以从“变量”面板的“变量类型”下拉列表中访问该菜单。系统将显示“浏览并选择 .Net 类型”窗口。

2. 在“类型名称”字段中，为要查找的变量键入关键字，如 Excel。注意，结果部分已经更新，显示包含您的关键字的所有 .Net 变量类型。

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

   

   备注：

   在首次使用“浏览并选择 .Net 类型”窗口中的一种变量类型后，该类变量将显示在“变量”面板的“变量类型”下拉列表中。

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

备注：

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

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