Udostępnij za pośrednictwem

Microsoft.Common.FileUpload, element interfejsu użytkownika

  • Artykuł

Kontrolka, która umożliwia użytkownikowi określenie co najmniej jednego pliku do przekazania.

Przykład interfejsu użytkownika

Zrzut ekranu przedstawiający element interfejsu użytkownika Microsoft.Common.FileUpload w witrynie Azure Portal.

Schemat

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

Przykładowe dane wyjściowe

Jeśli options.multiple element to false i options.uploadMode ma filewartość , dane wyjściowe zawierają zawartość pliku jako ciąg JSON:

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

Jeśli options.multiple element to true i options.uploadMode ma filewartość , dane wyjściowe zawierają zawartość plików jako tablicę 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."
]

Jeśli options.multiple element to false i options.uploadMode to url, dane wyjściowe mają adres URL jako ciąg 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"

Jeśli options.multiple element to true i options.uploadMode ma urlwartość , dane wyjściowe zawierają listę adresów URL jako tablicę 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"
]

Podczas testowania CreateUiDefinition.json niektóre przeglądarki obcinają adresy URL wygenerowane przez Microsoft.Common.FileUpload element w konsoli przeglądarki. Aby skopiować pełne adresy URL, może być konieczne kliknięcie prawym przyciskiem myszy pojedynczych linków.

Uwagi

  • constraints.accept określa typy plików wyświetlanych w oknie dialogowym pliku przeglądarki. Zobacz specyfikację HTML5 dla dozwolonych wartości. Domyślna wartość to null.
  • Jeśli options.multiple ustawiono wartość true, użytkownik może wybrać więcej niż jeden plik w oknie dialogowym pliku przeglądarki. Domyślna wartość to false.
  • Ten element obsługuje przekazywanie plików w dwóch trybach na podstawie wartości options.uploadMode. Jeśli file zostanie określony, dane wyjściowe zawierają zawartość pliku jako obiekt blob. Jeśli url zostanie określony, plik zostanie przekazany do lokalizacji tymczasowej, a dane wyjściowe zawierają adres URL obiektu blob. Tymczasowe obiekty blob zostaną przeczyszczone po 24 godzinach. Domyślna wartość to file.
  • Przekazany plik jest chroniony. Adres URL danych wyjściowych zawiera token SYGNATURy dostępu współdzielonego do uzyskiwania dostępu do pliku podczas wdrażania.
  • Wartość określa options.openMode sposób odczytywania pliku. Jeśli plik ma być zwykły tekst, określ text w przeciwnym razie wartość binary. Domyślna wartość to text.
  • Jeśli options.uploadMode jest ustawiona file wartość i options.openMode jest ustawiona na binary, dane wyjściowe są zakodowane w formacie base64.
  • options.encoding określa kodowanie, które ma być używane podczas odczytywania pliku. Wartość domyślna to UTF-8, i jest używana tylko wtedy, gdy options.openMode jest ustawiona na textwartość .

Następne kroki