Microsoft.Common.FileUpload UI-element
En kontroll som gör att en användare kan ange en eller flera filer som ska laddas upp.
Exempel på användargränssnitt
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
}
Exempelutdata
Om options.multiple
är false
och options.uploadMode
är file
har utdata innehållet i filen som en JSON-sträng:
"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."
Om options.multiple
är true
och options.uploadMode
är file
har utdata innehållet i filerna som en JSON-matris:
[
"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."
]
Om options.multiple
är false
och options.uploadMode
är url
har utdata en URL som en JSON-sträng:
"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"
Om options.multiple
är true
och options.uploadMode
är url
har utdata en lista över URL:er som en JSON-matris:
[
"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"
]
När du testar en CreateUiDefinition.json trunkerar vissa webbläsare URL:er som genereras av elementet Microsoft.Common.FileUpload
i webbläsarkonsolen. Du kan behöva högerklicka på enskilda länkar för att kopiera de fullständiga URL:erna.
Kommentarer
constraints.accept
anger vilka typer av filer som visas i webbläsarens fildialogruta. Se HTML5-specifikationen för tillåtna värden. Standardvärdet ärnull
.- Om
options.multiple
är inställt påtrue
får användaren välja fler än en fil i webbläsarens fildialogruta. Standardvärdet ärfalse
. - Det här elementet stöder uppladdning av
options.uploadMode
filer i två lägen baserat på värdet för . Omfile
anges har utdata innehållet i filen som en blob. Omurl
anges laddas filen upp till en tillfällig plats och utdata har blobens URL. Tillfälliga blobar rensas efter 24 timmar. Standardvärdet ärfile
. - En uppladdad fil skyddas. Utdata-URL:en innehåller en SAS-token för åtkomst till filen under distributionen.
- Värdet
options.openMode
för avgör hur filen läss. Om filen förväntas vara oformaterad text anger dutext
binary
annars . Standardvärdet ärtext
. - Om
options.uploadMode
är inställt påfile
ochoptions.openMode
är inställt påbinary
är utdata base64-kodade. options.encoding
anger vilken kodning som ska användas vid läsning av filen. Standardvärdet ärUTF-8
, och används endast näroptions.openMode
är inställt påtext
.
Nästa steg
- En introduktion till hur du skapar användargränssnittsdefinitioner finns i Komma igång med CreateUiDefinition.
- En beskrivning av vanliga egenskaper i gränssnittselement finns i CreateUiDefinition-element.