Compartilhar via


Elemento de interface do usuário Microsoft.Common.FileUpload

Um controle que permite a um usuário especificar um ou mais arquivos a carregar.

Exemplo de interface do usuário

Captura de tela do elemento de interface do usuário do Microsoft.Common.FileUpload no portal do Azure.

Esquema

{
  "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
}

Saída de exemplo

Se options.multiple for false e options.uploadMode for file, a saída terá o conteúdo do arquivo como uma cadeia de caracteres JSON:

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

Se options.multiple for true e options.uploadMode for file, a saída terá o conteúdo dos arquivos como uma matriz 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."
]

Se options.multiple for false e options.uploadMode for url, a saída terá uma URL como uma cadeia de caracteres 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"

Se options.multiple for true e options.uploadMode for url, a saída terá uma lista de URLs como uma matriz 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"
]

Quando você testa um CreateUiDefinition.json, alguns navegadores truncam Microsoft.Common.FileUpload URLs geradas pelo elemento no console do navegador. Talvez seja necessário clicar com o botão direito do mouse em links individuais para copiar as URLs completas.

Comentários

  • constraints.acceptEspecifica os tipos de arquivos que são mostrados no diálogo do arquivo do navegador. Consulte a especificação do HTML5 para obter os valores permitidos. O valor padrão é null.
  • Se options.multiple estiver definido como true, o usuário terá permissão para selecionar mais de um arquivo na caixa de diálogo de arquivos do navegador. O valor padrão é false.
  • Esse elemento dá suporte ao carregamento de arquivos em dois modos com base no valor de options.uploadMode. Se file for especificado, a saída terá o conteúdo do arquivo como um blob. Se url for especificado, o arquivo será carregado em um local temporário e a saída terá a URL do blob. Blobs temporários serão limpos após 24 horas. O valor padrão é file.
  • Um arquivo carregado é protegido. A URL de saída inclui um token SAS para acessar o arquivo durante a implantação.
  • O valor de options.openMode determina como o arquivo é lido. Se se espera que o arquivo seja texto sem formatação, especifique text de outra forma especificar binary. O valor padrão é text.
  • Se options.uploadMode estiver definido como file e options.openMode estiver definido como binary, a saída será codificada em base64.
  • options.encodingEspecifica a codificação a ser usada para ler o arquivo. O valor padrão é UTF-8, e é usado somente quando options.openMode é definido como text.

Próximas etapas