Condividi tramite

Elemento Microsoft.Common.FileUpload dell'interfaccia utente

  • Articolo

Controllo che consente a un utente di specificare uno o più file da caricare.

Esempio di interfaccia utente

Screenshot dell'elemento Microsoft.Common.FileUpload UI in portale di Azure.

Schema

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

Output di esempio

Se options.multiple è e options.uploadMode è filefalse , l'output ha il contenuto del file come stringa JSON:

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

Se options.multiple è e options.uploadMode è filetrue , l'output ha il contenuto dei file come matrice 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 è e options.uploadMode è urlfalse , l'output ha un URL come stringa 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 è e options.uploadMode è urltrue , l'output ha un elenco di URL come matrice 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 si testa un CreateUiDefinition.json, alcuni browser troncano gli URL generati dall'elemento Microsoft.Common.FileUpload nella console del browser. Potrebbe essere necessario fare clic con il pulsante destro del mouse su singoli collegamenti per copiare gli URL completi.

Osservazioni:

  • constraints.accept specifica i tipi di file visualizzati nella finestra di dialogo del browser relativa ai file. Per informazioni sui valori consentiti, vedere la specifica HTML5. Il valore predefinito è null.
  • Se options.multiple è impostato su true, l'utente può selezionare più file nella finestra di dialogo del file del browser. Il valore predefinito è false.
  • Questo elemento supporta il caricamento dei file in due modalità in base al valore di options.uploadMode. Se file viene specificato, l'output ha il contenuto del file come BLOB. Se url viene specificato, il file viene caricato in un percorso temporaneo e l'output ha l'URL del BLOB. I BLOB temporanei verranno eliminati dopo 24 ore. Il valore predefinito è file.
  • Un file caricato è protetto. L'URL di output include un token di firma di accesso condiviso per l'accesso ai file durante la distribuzione.
  • Il valore di options.openMode determina la modalità di lettura del file. Se il file deve essere testo normale, specificare text binaryin caso contrario . Il valore predefinito è text.
  • Se options.uploadMode è impostato su e options.openMode è impostato file su binary, l'output è con codifica Base64.
  • options.encoding specifica la codifica da usare per la lettura del file. Il valore predefinito è UTF-8e viene usato solo quando options.openMode è impostato su text.

Passaggi successivi