「檔案上載」小器具可讓使用者將一或多個檔案上載至 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 時顯示失敗訊息。

如需有關使用通用驗證內容的詳細資訊，請參閱文字欄位小器具 (主題化)。

下表列出了 ThingWorx 9.3.4 或更新版本中「驗證」面板上可用的驗證內容。