Microsoft.Common.FileUpload UI 元素

控制項可讓使用者指定要上傳的一個或多個檔案。

UI 範例

結構描述

{
  "name": "element1",
  "type": "Microsoft.Common.FileUpload",
  "label": "Some file upload",
  "toolTip": "",
  "constraints": {
    "required": true,
    "accept": ".doc,.docx,.xml,application/msword"
  },
  "options": {
    "multiple": false,
    "uploadMode": "file",
    "openMode": "text",
    "encoding": "UTF-8"
  },
  "visible": true
}

範例輸出

如果 options.multiple 是 且 options.uploadMode 為 filefalse ，則輸出會以 JSON 字串的形式包含檔案的內容：

"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."

如果 options.multiple 是 true 且 options.uploadMode 為 file，則輸出會以 JSON 陣列的形式包含檔案的內容：

[
  "Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.",
  "Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.",
  "Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur.",
  "Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum."
]

如果 options.multiple 是 且 options.uploadMode 為 urlfalse ，則輸出具有 JSON 字串的網址：

"https://contoso.blob.core.windows.net/pictures/profile.jpg?sv=2013-08-15&st=2013-08-16&se=2013-08-17&sr=c&sp=r&rscd=file;%20attachment&rsct=binary &sig=YWJjZGVmZw%3d%3d&sig=a39%2BYozJhGp6miujGymjRpN8tsrQfLo9Z3i8IRyIpnQ%3d"

如果 options.multiple 是 且 options.uploadMode 為 urltrue ，則輸出會以 JSON 陣列的形式列出 URL：

[
  "https://contoso.blob.core.windows.net/pictures/profile1.jpg?sv=2013-08-15&st=2013-08-16&se=2013-08-17&sr=c&sp=r&rscd=file;%20attachment&rsct=binary &sig=YWJjZGVmZw%3d%3d&sig=a39%2BYozJhGp6miujGymjRpN8tsrQfLo9Z3i8IRyIpnQ%3d",
  "https://contoso.blob.core.windows.net/pictures/profile2.jpg?sv=2013-08-15&st=2013-08-16&se=2013-08-17&sr=c&sp=r&rscd=file;%20attachment&rsct=binary &sig=YWJjZGVmZw%3d%3d&sig=a39%2BYozJhGp6miujGymjRpN8tsrQfLo9Z3i8IRyIpnQ%3d",
  "https://contoso.blob.core.windows.net/pictures/profile3.jpg?sv=2013-08-15&st=2013-08-16&se=2013-08-17&sr=c&sp=r&rscd=file;%20attachment&rsct=binary &sig=YWJjZGVmZw%3d%3d&sig=a39%2BYozJhGp6miujGymjRpN8tsrQfLo9Z3i8IRyIpnQ%3d"
]

當您測試 CreateUiDefinition.json時，某些瀏覽器會截斷瀏覽器控制台中 元素所產生的 Microsoft.Common.FileUpload URL。 您可能需要以滑鼠右鍵按下個別連結，以複製完整的URL。

備註

• constraints.accept 會指定在瀏覽器的 [檔案] 對話方塊中顯示的檔案類型。 請參閱 HTML5 規格 以取得允許的值。 預設值是 null。
• 如果 options.multiple 設定為 true，則允許使用者在瀏覽器的檔案對話框中選取多個檔案。 預設值是 false。
• 這個元素會根據 options.uploadMode 的值，支援兩種檔案上傳模式。 如果 file 指定 ，則輸出會以 Blob 的形式包含檔案的內容。 如果 url 指定 ，則會將檔案上傳至暫存位置，而輸出具有 Blob 的 URL。 24 小時之後，就會清除暫存 blob。 預設值是 file。
• 上傳的檔案已受保護。 輸出 URL 包含 SAS 權杖，可供在部署期間存取檔案。
• options.openMode 的值會決定讀取檔案的方式。 如果檔案必須是純文字，請指定 ，否則請指定 text binary。 預設值是 text。
• 如果 options.uploadMode 設定為 file 且 options.openMode 設定為 binary，則輸出會以base64編碼。
• options.encoding 會指定讀取檔案時要使用的編碼方式。 默認值為 UTF-8，且只有在 設定為 text時才options.openMode使用。

下一步

• 如需建立 UI 定義的簡介，請參閱開始使用 CreateUiDefinition。
• 如需 UI 元素中通用屬性的說明，請參閱 CreateUiDefinition 元素。