Partage via

Élément d’interface utilisateur Microsoft.Common.FileUpload

  • Article

Contrôle qui permet à un utilisateur de spécifier un ou plusieurs fichiers à charger.

Exemple d’interface utilisateur

Capture d’écran de l’élément d’interface utilisateur Microsoft.Common.FileUpload pour le Portail Azure.

schéma

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

Exemple de sortie

Si options.multiple c’est filefalse le cas, options.uploadMode la sortie a le contenu du fichier sous la forme d’une chaîne JSON :

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

Si options.multiple c’est filetrue le cas, options.uploadMode la sortie contient le contenu des fichiers sous la forme d’un tableau 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."
]

Si options.multiple c’est urlfalse le cas, options.uploadMode la sortie a une URL sous forme de chaîne 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"

Si options.multiple c’est urltrue le cas, options.uploadMode la sortie comporte une liste d’URL sous la forme d’un tableau 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"
]

Lorsque vous testez un CreateUiDefinition.json, certains navigateurs tronquent les URL générées par l’élément dans la Microsoft.Common.FileUpload console du navigateur. Vous devrez peut-être cliquer avec le bouton droit sur des liens individuels pour copier les URL complètes.

Notes

  • constraints.accept spécifie les types de fichiers qui figurent dans la boîte de dialogue du navigateur. Consultez la spécification HTML5 pour connaître les valeurs autorisées. La valeur par défaut est null.
  • Si options.multiple la valeur est définie true, l’utilisateur est autorisé à sélectionner plusieurs fichiers dans la boîte de dialogue de fichier du navigateur. La valeur par défaut est false.
  • Cet élément prend en charge le chargement de fichiers dans deux modes basés sur la valeur de options.uploadMode. Si file elle est spécifiée, la sortie contient le contenu du fichier en tant qu’objet blob. Si url elle est spécifiée, le fichier est chargé à un emplacement temporaire et la sortie a l’URL de l’objet blob. Les objets blob temporaires sont purgés après 24 heures. La valeur par défaut est file.
  • Un fichier chargé est protégé. L’URL de sortie inclut un jeton SAS pour accéder au fichier durant le déploiement.
  • La valeur de options.openMode détermine la façon dont le fichier est lu. Si le fichier est censé être en texte brut, spécifiez text sinon .binary La valeur par défaut est text.
  • Si options.uploadMode elle est définie file sur et options.openMode est définie binarysur , la sortie est encodée en base64.
  • options.encoding spécifie l’encodage à utiliser lors de la lecture du fichier. La valeur par défaut est UTF-8, et est utilisée uniquement quand options.openMode elle est définie sur text.

Étapes suivantes