文件上载小组件允许用户将一个或多个文件上载至 ThingWorx 信息库。可通过以下方式之一将小组件配置为上载文件：

此外，还可配置验证规则，以对文件类型、大小、数量等应用限制。

拖放

在此模式下拖动或选择文件时，系统将根据 DisableInstantUpload 属性的值即时上载或列出文件。或者，可使用按钮或小组件 Upload 服务手动禁用 AllowInstantUpload 属性并上载文件。此外，还会显示“替换”按钮，通过此按钮可替换信息库中的已上载文件。

仅浏览按钮

默认情况下，选定文件会自动上载至信息库。每个上载文件均显示有对应的进度条。

为使用户能够在上载前对选定文件进行查看，请将小组件 DisbaleInstantUpload 和 ShowUploadButton 属性设置为 true。运行时，用户可通过单击“上载”按钮开始上载。或者，将混搭、函数或小组件事件绑定至小组件 Upload 服务，以根据特定条件启动上载。

可添加“删除”按钮以便用户能够停止上载并从列表中移除选定文件。已上载文件仅从列表中移除，不会从 ThingWorx 信息库中删除。要删除信息库中的文件，请使用自定义数据服务。

默认情况下，用户可通过可用控件来选择存储库以及作为文件上载目标的文件夹。要防止用户选取信息库或文件夹路径，请将 ShowRepositorySelector 和 ShowRepositoryPath 属性设置为 false。可使用小组件 RepositoryName 和 Path 属性指定默认的信息库名称和文件夹。有关平台中信息库的详细信息，请参阅管理文件信息库。

默认情况下，用户可在运行时上载任意大小的文件。可使用“验证”面板上的小组件 MaxFileSize 属性限制可上载的最大文件大小。要自定义文件大于最大文件允许大小时显示的失败消息，请配置 MaxFileSizeFailureMessage 和 MaxFileSizeFailureTitle 属性。

可使用 MaxUploadSize 验证属性限制总上载大小。如果总上载大小超出限制，则会显示失败消息。要自定义错误消息，请使用 MaxUploadSizeFailureMessage 和 MaxUploadSizeFailureTitle 属性。

可使用“验证”面板上的小组件 MaxFileSize 属性限制用户可上载的最大文件数。当选定的文件数大于所允许的最大文件数时，会显示一条失败消息。要自定义错误消息，请使用 MaxNumberOfFilesFailureMessage 属性。

可使用 AllowedFileTypes 属性对小组件进行配置以接受特定文件格式。可添加多个文件类型，并以逗号分隔。例如，若键入 .pdf, .png，则仅允许 PDF 和 PNG 文件。使用 AllowedFileTypesMessage 和 AllowedFileTypesTitle 属性可自定义添加不受支持的文件类型时所显示的错误消息。

可将文件拖至拖放区域，或单击标签打开文件选择对话框。区域颜色会自动更改，以指示是否可以拖放文件。

可使用以下属性配置拖放区域：

下表列出了“属性”面板上提供的属性。

与其他支持验证的小组件不同，文件上载不支持验证和条件消息。可定义条件消息，并启用 ShowFailureMessage 以在 ValidationState 为 Invalid 时显示失败消息。

有关使用常用验证属性的详细信息，请参阅文本字段小组件 (可应用主题)。

下表列出了“验证”面板上提供的验证属性。