Uploader für mehrere Dateien

Sie können mehrere Dateien mit dem Steuerelement Multi File Uploader auswählen und hochladen, das den Wert als IResource -Liste festlegt.

Hinweis:

Öffentliche Apps unterstützen das Steuerelement für den Uploader mehrerer Dateien nicht.

Arbeiten mit IResource

Wenn Sie eine Datei als ILocalResource erhalten, wird sie automatisch in eine IResource konvertiert, indem Folgendes verwendet wird:

JobAttachment.fromResource(file) // file is an ILocalResource

Wichtig:

Die folgenden Funktionen sind veraltet und sollten nicht mehr verwendet werden:

• .toLocalResource
• .toAppsFile

Allgemein

• Max. Dateigröße – Die maximale Dateigröße jeder Datei, die Sie hochladen können. Die empfohlene maximale Dateigröße beträgt 10 MB.

  Hinweis:

  Sie können maximal 10 Dateien hochladen.

• Zulässige Dateitypen – Die Dateitypen, die Sie hochladen können. Verwenden Sie ein Komma , , um Dateierweiterungen zu trennen. Wenn Sie z. B. .jpg, .png, .svg schreiben, können Sie nur diese Dateitypen hochladen. Das Punkt-Symbol . ist beim Auflisten der Dateitypen nicht obligatorisch.

• Hilfstext – Der Hilfetext, der bei der Laufzeit angezeigt werden soll.

• Tooltip – Der Text, der angezeigt werden soll, wenn ein App-Benutzer mit dem Mauszeiger auf das Steuerelement zeigt. Damit können Sie zusätzliche Informationen über das Steuerelement bereitstellen.

• Beschriftung – Der Anzeigetext des Steuerelements.

• Erforderlich – Bei „true“ müssen App-Benutzer Daten im Steuerelement angeben. Um das Steuerelement zur Laufzeit als obligatorisch zu markieren, wird nach dem Beschriftungstext ein Sternchen (*) hinzugefügt.

• Benutzerdefinierte Fehlermeldung – Der Text, der angezeigt wird, wenn die Eigenschaft Erforderlich auf „true“ festgelegt ist und das Steuerelement leer bleibt.

• Ausgeblendet – Bei „true“ wird das Steuerelement zur Laufzeit ausgeblendet.

Events

• Wert geändert – Konfigurieren Sie, was passiert, wenn eine Datei hinzugefügt oder aus der Auswahl entfernt wird.

Stil

• Ausrichtung von Steuerelementen – Erbt standardmäßig die übergeordnete Ausrichtung. Eine andere Ausrichtung als die übergeordnete kann festgelegt werden. Um die Standardausrichtung wiederherzustellen, heben Sie die Markierung der überschriebenen Optionen auf.

Hinweis:

Die Ausrichtung hängt vom Layout ab, das für das übergeordnete Element ausgewählt wurde, z. B. Vertikal oder Horizontal.

• Beschriftungsplatzierung – Standardmäßig wird die Beschriftung oben auf dem Steuerelement angezeigt, ausgerichtet nach links. Sie können es links neben dem Steuerelement in derselben Zeile platzieren. Die Eigenschaft Beschriftungsbreite konfiguriert, wie breit die Beschriftung sein soll, und die Eigenschaft Zwischenraum legt den Abstand zwischen der Beschriftung und dem Steuerelement fest.
• Schriftart – Die Schriftattribute für sowohl den Beschriftungs- als auch den Eingabetext, z. B. Schriftfamilie, Größe, Farbe oder Stil, etwa fett, kursiv und unterstrichen. Standardmäßig erbt das Steuerelement die Schriftfamilie des unmittelbar übergeordneten Containers, der durch das Schlüsselwort Geerbt angegeben wird.
• Seitenrand – Der Seitenrand des Steuerelements. Standardmäßig ist ein Seitenrand von 4px festgelegt. Die auf den Seitenrand bezogenen Eigenschaften „Oben/Unten“ und „Links/Rechts“ werden kombiniert. Diese Eigenschaften können mit der Schaltfläche Link rechts neben dem Abschnitt Seitenrand getrennt werden.
• Größe – Die Breite und Höhe des Steuerelements. Standardmäßig ist die Größe auf auto festgelegt. Um Mindest- oder Höchstwerte festzulegen, wählen Sie das Drei-Punkte-Symbol (...) aus.

VB-Eigenschaften

VB-Eigenschaft	Datentyp	Beschreibung
Tooltip	String	Informationstext, der angezeigt wird, wenn der Benutzer mit dem Mauszeiger auf das Dateiuploadprogramm zeigt.
Label	String	Die Bezeichnung des Dateiuploadprogramms, in der Regel Text, der vor dem Steuerelement angezeigt wird.
Value	IRessource	Name der aktuell hochgeladenen Datei.
Required	Boolescher	Gibt an, ob der Dateiupload obligatorisch ist.
RequiredErrorMessage	String	Meldung, die angezeigt wird, wenn der Dateiupload erforderlich ist, aber nicht angegeben wurde.
Hidden	Boolescher	Bestimmt die Sichtbarkeit des Dateiuploadprogramm- Steuerelements. Bei „true“ wird das Steuerelement zur Laufzeit ausgeblendet.
Disabled	Boolescher	Bestimmt, ob das Dateiuploadprogramm- Steuerelement interaktionsfähig ist. Bei „true“ wird die Interaktion mit dem Dateiuploadprogramm zur Laufzeit deaktiviert.
IsValid	Boolescher	Überprüft die Gültigkeit des Dateiuploadprogramm- Werts. Bei „true“ ist sie gültig.

Verwenden des Dateiuploadprogramms

Dieses Beispiel zeigt, wie Sie das Multi-File-Uploader mit einem Speicher-Bucket verwenden können:

1. Öffnen Sie eine bereits vorhandene App oder erstellen Sie eine neue.

• Fügen Sie ein Steuerelement für den Upload mehrerer Dateien hinzu.
• Wählen Sie Ereignisse aus. Wählen Sie in Wert geändert die Option Automatisierung definieren aus.

2. Fügen Sie eine For Each- Aktivität hinzu, die die Dateiauswahl durchläuft.
   • Sie können den Ausdruck Controls.MainPage.MultiFileUploader.Value verwenden.
   • Fügen Sie eine Upload Storage File- Aktivität in For Each hinzu.
     • Geben Sie den Orchestrator-Ordnerpfad und den Namen des Speicher-Buckets an.
     • Wählen Sie im Feld Datei den Ausdruck currentIResource aus.
     • Wählen Sie im Feld Uploadziel den Ausdruck currentIResource.FullName aus.
3. Testen oder führen Sie Ihre App aus.

Wenn Sie die App ausführen und mehrere Dateien im Multi-Datei-Uploader hinzufügen, lädt die App die Speicherdatei in den Speicher-Bucket hoch.