Elemen UI Microsoft.Common.FileUpload

Kontrol yang memungkinkan pengguna menentukan satu atau beberapa file untuk diunggah.

Sampel UI

Skema

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

Sampel output

Jika options.multiple adalah false dan options.uploadMode adalah file, maka output memiliki konten file sebagai string JSON:

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

Jika options.multiple adalah true dan options.uploadMode adalah file, maka output memiliki konten file sebagai array 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."
]

Jika options.multiple adalah false dan options.uploadMode adalah url, maka output memiliki URL sebagai string 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"

Jika options.multiple adalah true dan options.uploadMode adalah url, maka output memiliki daftar URL sebagai array 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"
]

Saat Anda menguji CreateUiDefinition.json, beberapa browser memotong URL yang dihasilkan oleh Microsoft.Common.FileUpload elemen di konsol browser. Anda mungkin perlu mengklik kanan tautan individual untuk menyalin URL lengkap.

Keterangan

• constraints.accept menentukan tipe file yang diperlihatkan dalam dialog file browser. Lihat spesifikasi HTML5 untuk nilai yang diizinkan. Nilai defaultnya adalah null.
• Jika options.multiple diatur ke true, pengguna diizinkan untuk memilih lebih dari satu file dalam dialog file browser. Nilai defaultnya adalah false.
• Elemen ini mendukung pengunggahan file dalam dua mode berdasarkan nilai options.uploadMode. Jika file ditentukan, output memiliki konten file sebagai blob. Jika url ditentukan, maka file diunggah ke lokasi sementara, dan output memiliki URL blob. Blob sementara akan dibersihkan setelah 24 jam. Nilai defaultnya adalah file.
• File yang diunggah dilindungi. URL output menyertakan token SAS untuk mengakses file selama penyebaran.
• Nilai options.openMode menentukan bagaimana file dibaca. Jika file diharapkan menjadi teks biasa, tentukan jika tidak tentukan text binary. Nilai defaultnya adalah text.
• Jika options.uploadMode diatur ke file dan options.openMode diatur ke binary, output dikodekan base64.
• options.encoding menentukan pengkodean yang akan digunakan saat membaca file. Nilai defaultnya adalah UTF-8, dan hanya digunakan saat options.openMode diatur ke text.

Langkah berikutnya

• Untuk pengantar mengenai cara membuat definisi antarmuka pengguna, lihat Mulai menggunakan CreateUiDefinition.
• Untuk deskripsi properti umum dalam elemen antarmuka pengguna, lihat elemen CreateUiDefinition.