多文件上传器

您可以使用“多文件上传器”控件选择并上传多个文件，该控件会将值设置为IResource列表。

备注：

公共Apps不支持“多文件上传器”控件。

使用 IResource

如果您以ILocalResource形式获取文件，则系统会使用以下方法自动将其转换为IResource ：

JobAttachment.fromResource(file) // file is an ILocalResource

重要提示：

以下函数已被弃用，您不应再使用它们：

• .toLocalResource
• .toAppsFile

常规

• “最大文件大小”- 可以上传的每个文件的最大文件大小。建议的最大文件大小为 10 MB。

  备注：

  您最多可以上传 10 个文件。

• “允许的文件类型” - 可以上传的文件类型。使用逗号,分隔文件扩展名。例如，如果您写入.jpg 、 .png 、 .svg ，则只能上传这些文件类型。列出文件类型时，点.符号不是必需的。

• “帮助程序文本”- 设置要在 Runtime 显示的帮助文本。

• “工具提示” - 当应用程序用户将鼠标悬停在控件上时要显示的文本。使用此选项可提供有关控件的其他信息。

• “标签”- 控件的显示文本。

• “必需” - 如果设置为“True”，则应用程序用户必须在控件中提供数据。要在 Runtime 将控件标记为必需，请在标签文本后添加星号 (*)。

• “自定义错误消息”- 当“必需”属性设置为 True 且控件留空时要显示的文本。

• “隐藏” - 如果设置为“True”，则在 Runtime 隐藏该控件。

Events

• “值已更改” - 配置在选择中添加或删除文件时会发生的情况。

样式

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

备注：

对齐方式取决于为父元素选择的布局，例如垂直或水平。

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

VB 属性

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

使用文件上传器

此示例显示了如何将多文件上传器与存储桶一起使用：

1. 打开现有应用程序，或创建新应用程序。

• 添加“多文件上传器”控件。
• 选择“事件” 。在“值已更改”中，选择“定义自动化” 。

2. 添加一个遍历所选文件的“遍历循环”活动。
   • 您可以使用表达式Controls.MainPage.MultiFileUploader.Value 。
   • 在“遍历循环”中添加“上传存储文件”活动。
     • 指定 Orchestrator 文件夹路径和存储桶名称。
     • 在“文件”字段中，选择表达式currentIResource 。
     • 在“上传位置” 字段中，选择表达式currentIResource.FullName 。
3. 测试或运行您的应用程序。

当您运行应用程序并在多文件上传器中添加多个文件时，应用程序会将存储文件上传到存储桶。