Benutzeroberflächenelement „Microsoft.Common.FileUpload“

Ein Steuerelement, mit dem Benutzer hochzuladende Dateien angeben können.

Benutzeroberflächenbeispiel

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
}

Beispielausgabe

Wenn options.multiple und false options.uploadMode ist file, hat die Ausgabe den Inhalt der Datei als JSON-Zeichenfolge:

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

Wenn options.multiple und true options.uploadMode ist file, hat die Ausgabe den Inhalt der Dateien als JSON-Array:

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

false Ist options.multiple dies der urloptions.uploadMode Wert, hat die Ausgabe eine URL als JSON-Zeichenfolge:

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

Wenn options.multiple und true options.uploadMode ist url, hat die Ausgabe eine Liste von URLs als JSON-Array:

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

Wenn Sie eine CreateUiDefinition.json testen, werden einige Browser URLs abgeschnitten, die Microsoft.Common.FileUpload vom Element in der Browserkonsole generiert wurden. Möglicherweise müssen Sie mit der rechten Maustaste auf einzelne Links klicken, um die vollständigen URLs zu kopieren.

Hinweise

• constraints.accept gibt die Typen von Dateien an, die im Dateidialogfeld des Browsers angezeigt werden. Zulässige Werte finden Sie in der HTML5-Spezifikation. Der Standardwert ist null.
• Wenn options.multiple dieser Wert festgelegt trueist, darf der Benutzer im Dateidialogfeld des Browsers mehrere Dateien auswählen. Der Standardwert ist false.
• Dieses Element unterstützt das Hochladen von Dateien basierend auf dem Wert für options.uploadMode in zwei Modi. Wenn file angegeben, weist die Ausgabe den Inhalt der Datei als Blob auf. Wenn url angegeben, wird die Datei an einen temporären Speicherort hochgeladen, und die Ausgabe hat die URL des Blobs. Temporäre Blobs werden nach 24 Stunden endgültig gelöscht. Der Standardwert ist file.
• Eine hochgeladene Datei ist geschützt. Die Ausgabe-URL enthält ein SAS-Token für den Zugriff auf die Datei während der Bereitstellung.
• Der Wert für options.openMode bestimmt, wie die Datei gelesen wird. Wenn die Datei als Nur-Text erwartet wird, geben Sie text andernfalls an binary. Der Standardwert ist text.
• Wenn options.uploadMode sie auf "base64" festgelegt file ist und options.openMode auf binarysie festgelegt ist, wird die Ausgabe base64-codiert.
• options.encoding gibt die beim Lesen der Datei zu verwendende Codierung an. Der Standardwert ist UTF-8, und wird nur verwendet, wenn options.openMode auf text.

Nächste Schritte

• Eine Einführung zum Erstellen von Benutzeroberflächendefinitionen finden Sie unter Erste Schritte mit „CreateUiDefinition“.
• Eine Beschreibung der allgemeinen Eigenschaften in Benutzeroberflächenelementen finden Sie unter CreateUiDefinition-Elemente.