文件上传工具

常规

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

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

Events

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

样式

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

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

• “标签放置”- 默认情况下，标签设置为显示在控件顶部的左侧。您可以将其放置在控件的左侧同一行。“标签宽度”属性配置标签的宽度，“间距”属性设置标签和控件之间的距离。

• “字体”- 标签和输入文本的字体属性，例如字体系列、大小、颜色或样式（粗体、斜体和下划线）。默认情况下，控件会继承直属父容器的字体系列，这由关键字“已继承”指示。

• “边距”- 控件的边距。默认情况下，边距设置为 4 像素。“上/下”和“左/右”边距属性结合使用。可以使用“边距”部分右侧的“链接”按钮分离这些属性。
• “大小”- 控件的宽度和高度。默认情况下，大小设置为 auto。要设置最小值或最大值，请单击三点图标 (...)。

使用文件上传器

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

1. 在您的应用程序中，添加一个存储桶和一个具有文件字段的 Data Service 实体。
2. 添加“文件上传器”和“按钮”控件。
3. 创建一个类型为“Apps 文件”的变量，并将其命名为“SB_file_var”。使用此变量存储从存储桶下载的文件。
4. 将“上传文件到存储桶”规则添加到按钮控件的“已单击”事件中。
   1. 在“要上传的文件”字段中，引用通过“文件上传器”控件上传的文件，如下所示：

      MainPage.FileUploader.Value

   2. 在“存储桶”字段中，引用您先前添加到应用程序的 Orchestrator 存储桶。
   3. （可选）在“完成后”字段中，您可以添加“显示消息”规则，以通知您已成功完成上传。
5. 将“从存储桶下载文件”规则添加到按钮控件的“已单击”事件中。
   1. 在“存储桶”字段中，引用您先前添加到应用程序的 Orchestrator 存储桶。
   2. 在“文件名（带扩展名）”字段中，写入用户应下载的文件的名称。
   3. 在“将文件分配给应用程序”变量中，引用先前创建的变量“SB_file_var”。
   4. （可选）在“完成后”字段中，您可以添加“显示消息”规则，以通知您已成功完成下载。
6. 向应用程序添加“标签”控件。
   1. 在控件的“文本”字段中，引用已下载文件的名称，如下所示：

      SB_file_var.Name

      - 其中“SB_file_var”是用于存储有关已下载文件的数据的变量。

7. 运行应用程序并使用“文件上传器”控件上传文件。单击按钮。

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

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