文件上传工具

常规

“最大文件大小”- 用户可以上传的最大文件大小。建议的最大文件大小为 10 MB。
“允许的文件类型”- 用户可以上传的文件类型。使用“,”分隔文件扩展名。例如，如果您写入 .jpg, .png, .svg，则仅允许上传这些文件类型。列出文件类型时，. 符号不是必需的。
“帮助程序文本”- 设置要在 Runtime 显示的帮助文本。
“工具提示”- 当应用程序用户将鼠标悬停在控件上时要显示的文本。使用此选项可提供有关控件的其他信息。
“标签”- 控件的显示文本。
“必需”- 如果为 True，则应用程序用户必须在控件中提供数据。要在 Runtime 将控件标记为必需，请在标签文本后添加星号 *。
“自定义错误消息”- 当“必需”属性设置为 True 且控件留空时要显示的文本。
隐藏 - 如果为 true，则在 Runtime 隐藏该控件。
“已禁用”- 如果为 True，则在 Runtime 禁用该控件。

注意：“文件选取器”控件一次只能上传一个文件。

Events

已添加文件- 配置添加文件时会发生的情况。
已删除文件- 配置删除文件时会发生的情况。

样式

“控件对齐”- 默认情况下，继承父级对齐方式。可以设置与父级对齐方式不同的对齐方式。要默认返回到父级对齐方式，请取消选择覆盖的选项。

注意：对齐方式取决于为父元素选择的布局（垂直与水平）。

“标签放置”- 默认情况下，标签设置为显示在控件顶部的左侧。您可以将其放置在控件的左侧同一行。“标签宽度”属性配置标签的宽度，“间距”属性设置标签和控件之间的距离。
“字体”- 标签和输入文本的字体属性，例如字体系列、大小、颜色或样式（粗体、斜体和下划线）。默认情况下，控件会继承直属父容器的字体系列，这由关键字“已继承”指示。
“边距”- 控件的边距。默认情况下，边距设置为 4 像素。“上/下”和“左/右”边距属性结合使用。可以使用“边距”部分右侧的“链接”按钮分离这些属性。
“大小”- 控件的宽度和高度。默认情况下，大小设置为 auto。要设置最小值或最大值，请单击三点图标 (...)。

使用文件上传器

此示例说明如何将文件上传器与存储桶和实体的文件字段一起使用。

在您的应用程序中，添加一个存储桶和一个具有文件字段的 Data Service 实体。
添加“文件上传器”和“按钮”控件。
创建一个类型为“Apps 文件”的变量，并将其命名为“SB_file_var”。使用此变量存储从存储桶下载的文件。
将“上传文件到存储桶”规则添加到按钮控件的“已单击”事件中。
1. 在“要上传的文件”字段中，引用通过“文件上传器”控件上传的文件，如下所示：
```
MainPage.FileUploader.ValueMainPage.FileUploader.Value
```
2. 在“存储桶”字段中，引用您先前添加到应用程序的 Orchestrator 存储桶。
3. （可选）在“完成后”字段中，您可以添加“显示消息”规则，以通知您已成功完成上传。
将“从存储桶下载文件”规则添加到按钮控件的“已单击”事件中。
1. 在“存储桶”字段中，引用您先前添加到应用程序的 Orchestrator 存储桶。
2. 在“文件名（带扩展名）”字段中，写入用户应下载的文件的名称。
3. 在“将文件分配给应用程序”变量中，引用先前创建的变量“SB_file_var”。
4. （可选）在“完成后”字段中，您可以添加“显示消息”规则，以通知您已成功完成下载。
向应用程序添加“标签”控件。
1. 在控件的“文本”字段中，引用已下载文件的名称，如下所示：
```
SB_file_var.NameSB_file_var.Name
```
  - 其中“SB_file_var”是用于存储有关已下载文件的数据的变量。
运行应用程序并使用“文件上传器”控件上传文件。单击按钮。

屏幕顶部应会显示一条成功消息，通知您已成功完成上传/下载。现在，检查 Orchestrator 中的存储桶时，您应该会看到使用“文件上传器”控件上传的文件。

同时，单击按钮将“从存储桶下载文件”规则中指示的文件下载到本地设备，并将其数据存储在变量中。“标签”控件显示已下载文件的名称。

VB 属性

VB 属性	数据类型	描述
工具提示	字符串	当用户将鼠标悬停在 “文件上传器”上时，显示的信息文本。
标签	字符串	文件上传器的标签，通常是显示在控件之前的文本。
值	`AppsFile`	当前上传的文件的名称。
必填	布尔值	指定是否必须上传文件。
RequiredErrorMessage	字符串	需要上传文件但未提供时显示的消息。
隐藏	布尔值	确定文件上传器控件的可见性。如果设置为 True，则在 Runtime 隐藏该控件。
已禁用	布尔值	确定文件上传器控件是否可交互。如果设置为 True，则禁用在运行时与文件上传器的交互。
有效	布尔值	检查文件上传器值的有效性。如果为 true，则表示它有效。