Compartilhar via

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

  • Artigo

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 string 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 string 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 URLs gerados pelo Microsoft.Common.FileUpload elemento no console do navegador. Talvez seja necessário clicar com o botão direito do mouse em links individuais para copiar os URLs completos.

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 poderá selecionar mais de um arquivo na caixa de diálogo de arquivo 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 o arquivo for um texto simples, especifique text caso contrário, especifique binary. O valor padrão é text.
  • Se options.uploadMode for definido como file e options.openMode 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 está definido como text.

Próximas etapas