Microsoft.Common.FileUpload UI öğesi

  • Makale

Kullanıcının karşıya yüklenecek bir veya daha fazla dosya belirtmesine olanak tanıyan denetim.

Kullanıcı arabirimi örneği

Azure portalında Microsoft.Common.FileUpload UI öğesinin ekran görüntüsü.

Şema

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

Örnek çıktı

options.multiple false ise ve options.uploadMode dosyasıysa çıktıda dosyanın içeriği JSON dizesi olarak bulunur:

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

options.multiple true ise ve'options.uploadMode dosyası ise çıktıda dosyaların içeriği JSON dizisi olarak bulunur:

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

options.multiple false ise ve options.uploadMode url ise çıktının JSON dizesi olarak bir URL'si vardır:

"https://myaccount.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"

options.multiple true ve options.uploadMode url ise çıktıda JSON dizisi olarak URL listesi bulunur:

[
  "https://myaccount.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://myaccount.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://myaccount.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"
]

CreateUiDefinition'ı test ederken, bazı tarayıcılar (Google Chrome gibi) tarayıcı konsolunda Microsoft.Common.FileUpload öğesi tarafından oluşturulan URL'leri kesmektedir. Tüm URL'leri kopyalamak için tek tek bağlantılara sağ tıklamanız gerekebilir.

Açıklamalar

  • constraints.accept tarayıcının dosya iletişim kutusunda gösterilen dosya türlerini belirtir. İzin verilen değerler için HTML5 belirtimine bakın. Varsayılan değer null'dır.
  • true olarak ayarlanırsaoptions.multiple, kullanıcının tarayıcının dosya iletişim kutusunda birden fazla dosya seçmesine izin verilir. Varsayılan değer false şeklindedir.
  • Bu öğe, değerine options.uploadModegöre dosyaları iki modda karşıya yüklemeyi destekler. Dosya belirtilirse, çıktıda dosyanın içeriği blob olarak bulunur. URL belirtilirse, dosya geçici bir konuma yüklenir ve çıktı blobun URL'sine sahiptir. Geçici bloblar 24 saat sonra temizlenir. Varsayılan değer dosyadır.
  • Karşıya yüklenen bir dosya korunur. Çıkış URL'si, dağıtım sırasında dosyaya erişmek için bir SAS belirteci içerir.
  • değeri options.openMode , dosyanın nasıl okundığını belirler. Dosyanın düz metin olması bekleniyorsa , metni belirtin; değilse, ikili değerini belirtin. Varsayılan değer metindir.
  • dosya olarak ayarlanırsa ve options.openModeikili olarak ayarlanırsaoptions.uploadMode, çıkış base64 kodlamalı olur.
  • options.encoding , dosyayı okurken kullanılacak kodlamayı belirtir. Varsayılan değer UTF-8'dir ve yalnızca options.openModemetne ayarlandığında kullanılır.

Sonraki adımlar