Delen via

Microsoft.Common.FileUpload UI-element

  • Artikel

Een besturingselement waarmee een gebruiker een of meer bestanden kan opgeven die moeten worden geüpload.

Ui-voorbeeld

Schermopname van het element Microsoft.Common.FileUpload UI in Azure Portal.

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
}

Voorbeelduitvoer

Als options.multiple dat het isfilefalse, options.uploadMode heeft de uitvoer de inhoud van het bestand als een JSON-tekenreeks:

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

Als options.multiple dat zo isfiletrue, options.uploadMode heeft de uitvoer de inhoud van de bestanden als een JSON-matrix:

[
  "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."
]

Als options.multiple dat het isurlfalse, options.uploadMode heeft de uitvoer een URL als een JSON-tekenreeks:

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

Als options.multiple dat zo isurltrue, options.uploadMode heeft de uitvoer een lijst met URL's als een JSON-matrix:

[
  "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"
]

Wanneer u een CreateUiDefinition.json test, worden in sommige browsers URL's afgekapt die door het Microsoft.Common.FileUpload element in de browserconsole worden gegenereerd. Mogelijk moet u met de rechtermuisknop op afzonderlijke koppelingen klikken om de volledige URL's te kopiëren.

Opmerkingen

  • constraints.accept hiermee geeft u de typen bestanden op die worden weergegeven in het bestandsdialoogvenster van de browser. Zie de HTML5-specificatie voor toegestane waarden. De standaardwaarde is null.
  • Als options.multiple dit is ingesteld true, mag de gebruiker meer dan één bestand selecteren in het dialoogvenster bestand van de browser. De standaardwaarde is false.
  • Dit element ondersteunt het uploaden van bestanden in twee modi op basis van de waarde van options.uploadMode. Als file dit is opgegeven, heeft de uitvoer de inhoud van het bestand als blob. Als url dit is opgegeven, wordt het bestand geüpload naar een tijdelijke locatie en heeft de uitvoer de URL van de blob. Tijdelijke blobs worden na 24 uur verwijderd. De standaardwaarde is file.
  • Een geüpload bestand is beveiligd. De uitvoer-URL bevat een SAS-token voor toegang tot het bestand tijdens de implementatie.
  • De waarde van options.openMode bepaalt hoe het bestand wordt gelezen. Als verwacht wordt dat het bestand tekst zonder opmaak is, geeft u text anders op binary. De standaardwaarde is text.
  • Als options.uploadMode dit is ingesteld op file en options.openMode is ingesteld binaryop , wordt de uitvoer base64-gecodeerd.
  • options.encoding hiermee geeft u de codering die moet worden gebruikt bij het lezen van het bestand. De standaardwaarde is UTF-8en wordt alleen gebruikt wanneer options.openMode deze is ingesteld op text.

Volgende stappen