Dela via


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

Skärmbild av UI-elementet Microsoft.Common.FileUpload i Azure-portalen.

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 filehar 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 filehar 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 urlhar 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 urlhar 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 är null.
  • Om options.multiple är inställt på truefår användaren välja fler än en fil i webbläsarens fildialogruta. Standardvärdet är false.
  • Det här elementet stöder uppladdning av options.uploadModefiler i två lägen baserat på värdet för . Om file anges har utdata innehållet i filen som en blob. Om url anges laddas filen upp till en tillfällig plats och utdata har blobens URL. Tillfälliga blobar rensas efter 24 timmar. Standardvärdet är file.
  • 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 du text binaryannars . Standardvärdet är text.
  • Om options.uploadMode är inställt på file och options.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 är UTF-8, och används endast när options.openMode är inställt på text.

Nästa steg