Compartir vía

Elemento de interfaz de usuario Microsoft.Common.FileUpload

  • Artículo

Control que permite al usuario especificar uno o varios archivos para cargar.

Ejemplo de interfaz de usuario

Captura de pantalla del elemento UI Microsoft.Common.FileUpload en el portal Azure.

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
}

Salida de ejemplo

Si options.multiple es y options.uploadMode es filefalse , la salida tiene el contenido del archivo como una cadena JSON:

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

Si options.multiple es y options.uploadMode es filetrue , la salida tiene el contenido de los archivos como una matriz 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."
]

Si options.multiple es y options.uploadMode es urlfalse , la salida tiene una dirección URL como una cadena 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"

Si options.multiple es y options.uploadMode es urltrue , la salida tiene una lista de direcciones URL como una matriz 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"
]

Al probar un CreateUiDefinition.json, algunos exploradores truncan las direcciones URL generadas por el Microsoft.Common.FileUpload elemento en la consola del explorador. Es posible que tenga que hacer clic con el botón derecho en vínculos individuales para copiar las direcciones URL completas.

Comentarios

  • constraints.accept especifica los tipos de archivos que se muestran en el cuadro de diálogo de archivo del explorador. Consulte la especificación HTML5 para ver los valores permitidos. El valor predeterminado es null.
  • Si options.multiple se establece trueen , el usuario puede seleccionar más de un archivo en el cuadro de diálogo de archivo del explorador. El valor predeterminado es false.
  • Este elemento permite cargar archivos de dos modos, en función del valor de options.uploadMode. Si file se especifica, la salida tiene el contenido del archivo como un blob. Si url se especifica , el archivo se carga en una ubicación temporal y la salida tiene la dirección URL del blob. Los blobs temporales se eliminan después de 24 horas. El valor predeterminado es file.
  • Un archivo cargado está protegido. La dirección URL de salida incluye un token de SAS para acceder al archivo durante la implementación.
  • El valor de options.openMode determina cómo se lee el archivo. Si se espera que el archivo sea texto sin formato, especifique text de lo contrario binary. El valor predeterminado es text.
  • Si options.uploadMode se establece file en y options.openMode se establece binaryen , la salida está codificada en base64.
  • options.encoding especifica la codificación que se utilizará al leer el archivo. El valor predeterminado es UTF-8y solo se usa cuando options.openMode se establece en text.

Pasos siguientes