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

Artigo
06/23/2024

Um controle que permite que um usuário especifique um ou mais arquivos para carregar.

Exemplo de interface do usuário

Captura de ecrã do elemento Microsoft.Common.FileUpload UI 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 é false e options.uploadMode é file, então a saída tem 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 é true e options.uploadMode é file, então a saída tem 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 é false e options.uploadMode é url, então a saída tem 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 é true e options.uploadMode é url, então a saída tem 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 geradas 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.

Observações

constraints.accept Especifica os tipos de arquivos que são mostrados na caixa de diálogo Arquivo do navegador. Consulte a especificação HTML5 para obter os valores permitidos. O valor predefinido é null.
Se options.multiple estiver definido como true, o usuário tem permissão para selecionar mais de um arquivo na caixa de diálogo de arquivo do navegador. O valor predefinido é false.
Este elemento suporta o carregamento de ficheiros em dois modos com base no valor de options.uploadMode. Se file for especificado, a saída tem 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. As bolhas temporárias serão purgadas após 24 horas. O valor predefinido é file.
Um ficheiro carregado está 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 o contrário binary. O valor predefinido é text.
Se options.uploadMode estiver definido como file e options.openMode estiver definido como binary, a saída será codificada em base64.
options.encoding Especifica a codificação a ser usada ao ler o arquivo. O valor padrão é UTF-8, e é usado somente quando options.openMode definido como text.

Próximos passos

Para obter uma introdução à criação de definições de interface do usuário, consulte Introdução a CreateUiDefinition.
Para obter uma descrição das propriedades comuns em elementos da interface do usuário, consulte Elementos CreateUiDefinition.

Partilhar via