Элемент пользовательского интерфейса Microsoft.Common.FileUpload

Статья
06/23/2024

Элемент управления, который позволяет пользователю указать один или несколько файлов для отправки.

Пример элемента пользовательского интерфейса

Снимок экрана: элемент пользовательского интерфейса Microsoft.Common.FileUpload в портал Azure.

Схема

{
  "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 это и options.uploadMode естьfiletrue, выходные данные имеют содержимое файлов в виде массива 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, выходные данные имеют URL-адрес в виде строки 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 есть true и options.uploadMode есть url, выходные данные имеют список URL-адресов в виде массива JSON:

[
  "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 некоторые браузеры усечены URL-адреса, созданные Microsoft.Common.FileUpload элементом в консоли браузера. Чтобы скопировать полные URL-адреса, может потребоваться щелкнуть правой кнопкой мыши отдельные ссылки.

Замечания

constraints.accept — указывает типы файлов, которые отображаются в файловом диалоговом окне браузера. Сведения о допустимых значениях см. в спецификации HTML5. Значение по умолчанию — null.
Если options.multiple задано значение true, пользователь может выбрать несколько файлов в диалоговом окне браузера. Значение по умолчанию — false.
Этот элемент поддерживает отправку файлов в двух режимах, которые задаются в параметре options.uploadMode. Если file задано, выходные данные имеют содержимое файла в виде большого двоичного объекта. Если url задано, файл передается во временное расположение, а выходные данные имеют URL-адрес большого двоичного объекта. Временные большие двоичные объекты очищаются через 24 часа. Значение по умолчанию — file.
Отправленный файл защищен. Выходной URL-адрес включает в себя маркер SAS для доступа к файлу во время развертывания.
Значение options.openMode определяет режим, в котором открывается файл. Если файл должен быть обычным текстом, укажите text binaryв противном случае. Значение по умолчанию — text.
Если options.uploadMode задано file значение и options.openMode задано binaryзначение, выходные данные закодированы в кодировке Base64.
options.encoding — указывает кодирование, которое используется при чтении файла. Значение по умолчанию — UTF-8и используется только в том случае, если options.openMode задано значение text.

Следующие шаги

Общие сведения о создании определений пользовательского интерфейса см. в статье Начало работы с CreateUiDefinition.
Дополнительные сведения об общих свойствах элементов пользовательского интерфейса см. в статье Элементы CreateUiDefinition.

Поделиться через