Element uživatelského rozhraní Microsoft.Common.FileUpload

Článek
06/23/2024

Ovládací prvek, který uživateli umožňuje zadat jeden nebo více souborů k nahrání.

Ukázka uživatelského rozhraní

Snímek obrazovky s elementem uživatelského rozhraní Microsoft.Common.FileUpload na webu Azure Portal

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
}

Ukázkový výstup

Pokud options.multiple je false a options.uploadMode je file, výstup obsahuje obsah souboru jako řetězec JSON:

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

Pokud options.multiple je true a options.uploadMode je file, výstup obsahuje obsah souborů jako pole 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."
]

Pokud options.multiple je false a options.uploadMode je url, výstup má adresu URL jako řetězec 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"

Pokud options.multiple je true a options.uploadMode je url, výstup obsahuje seznam adres URL jako pole 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"
]

Při testování CreateUiDefinition.json některé prohlížeče zkrátí adresy URL vygenerované elementem Microsoft.Common.FileUpload v konzole prohlížeče. Abyste mohli zkopírovat úplné adresy URL, budete možná muset kliknout pravým tlačítkem myši na jednotlivé odkazy.

Poznámky

constraints.accept určuje typy souborů, které se zobrazují v dialogovém okně souboru prohlížeče. Povolené hodnoty najdete ve specifikaci HTML5. Výchozí hodnota je null.
Pokud options.multiple je nastavená hodnota true, uživatel může v dialogovém okně souboru prohlížeče vybrat více souborů. Výchozí hodnota je false.
Tento prvek podporuje nahrávání souborů ve dvou režimech na základě hodnoty options.uploadMode. Pokud file je zadaný, výstup obsahuje obsah souboru jako objekt blob. Pokud url je zadaný, soubor se nahraje do dočasného umístění a výstup obsahuje adresu URL objektu blob. Dočasné objekty blob se vyprázdní po 24 hodinách. Výchozí hodnota je file.
Nahraný soubor je chráněný. Výstupní adresa URL obsahuje token SAS pro přístup k souboru během nasazování.
Hodnota options.openMode určuje, jak se soubor čte. Pokud se očekává, že soubor bude prostým textem, zadejte text jinak .binary Výchozí hodnota je text.
Pokud options.uploadMode je nastavena na a options.openMode je nastavena file na binary, výstup je kódován base64.
options.encoding určuje kódování, které se má použít při čtení souboru. Výchozí hodnota je UTF-8a používá se pouze v případě, že options.openMode je nastavena na text.

Další kroky

Úvod k vytváření definic uživatelského rozhraní najdete v tématu Začínáme s CreateUiDefinition.
Popis běžných vlastností elementů uživatelského rozhraní naleznete v tématu CreateUiDefinition elementy.

Sdílet prostřednictvím