Teilen über


Formular OnLoad-Ereignis

Dieses Ereignis tritt immer auf, wenn das Formular geladen wird, speziell:

  • Beim erstmaligen Laden einer Seite
  • Nachdem ein neuer Datensatz zuerst gespeichert (erstellt) wurde

Verwenden Sie die formContext.ui.addOnLoad und formContext.ui.removeOnLoad-Methode, um Ereignishandler für das Ereignis zu verwalten.

Hinweis

Steuerelemente in einem Formular sind möglicherweise nicht bereit, wenn das OnLoad-Ereignis eines Formulars eintritt. Verwenden Sie das OnLoad Ereignis des Steuerelements, um zu warten, bis es bereit ist. Weitere Informationen: Hinzufügen oder Entfernen von Ereignishandlerfunktion zum Ereignis mit UI

Asynchroner OnLoad-Ereignishandlersupport

Der OnLoad-Ereignishandler kann warten, bis die von Ereignishandlern zurückgegebenen Versprechen abgewickelt werden, bevor ein Formular geladen wird, wodurch ein OnLoad-Ereignis asynchron (async) sein kann. Das OnLoad-Ereignis wird asynchron, wenn der Ereignishandler ein Versprechen zurückgibt.

Das Formular wird geladen, wenn jedes vom Ereignishandler zurückgegebene Versprechen aufgelöst wird. Für alle zurückgegebenen Versprechen gilt ein Limit von 10 Sekunden für jedes Versprechen. Danach betrachtet die Plattform Versprechen als abgelaufen. Diese Zeitüberschreitung wird pro Versprechen angewendet. Wenn Sie beispielsweise fünf Versprechen zurückgegeben haben, beträgt die Gesamtwartezeit 50 Sekunden. Angenommen, das Versprechen wird abgelehnt oder eine Zeitüberschreitung tritt auf, dann verhält sich der Formularladevorgang weiterhin ähnlich wie bei den aktuellen Skriptfehlern.

Das OnLoad-Ereignis wartet nur auf ein Versprechen, das pro Handler zurückgegeben wird. Wenn mehrere Versprechen erforderlich sind, empfiehlt es sich, alle Versprechen in die Methode Promise.all() zu verpacken und das einzelne resultierende Versprechen zurückzugeben. Für mehrere Handler, die ein Versprechen zurückgeben, empfehlen wir, dass Sie einen Handler erstellen, der alle Ereignisse aufruft und ein einzelnes Versprechen zurückgibt, das alle erforderlichen Versprechen verpackt. Dies dient dazu, die durch die Zeitüberschreitung verursachten Wartezeiten zu minimieren.

Aktivieren Sie Async OnLoad über die App-Einstellung

Um asynchrone onLoad-Handler zu verwenden, müssen Sie sie über die App-Einstellung aktivieren. Eine App-Einstellung ist eine Plattformkomponente, mit der Sie unterstützte Funktionen für Ihre App aktivieren oder deaktivieren können. So aktivieren Sie asynchrone Onload-Ereignishandler für eine bestimmte App:

  1. Wechseln Sie zu https://make.powerapps.com.

  2. Stellen Sie sicher, dass Sie die richtige Umgebung auswählen.

  3. Wählen Sie im linken Navigationsbereich die Option Apps aus.

  4. Wählen Sie die App und dann ... (Auslassungspunkte) aus. Wählen Sie Bearbeiten.

  5. Wählen Sie in der Befehlsleiste Einstellungen aus.

  6. Wenn sich der Dialog öffnet, wählen Sie Funktionen.

  7. Schalten Sie Asynchroner onload-Handler ein.

  8. Wählen Sie Speichern.

    Asynchrone OnLoad-App-Einstellung

Asynchrone OnLoad-Zeitüberschreitungen

Bei Verwendung eines asynchronen Handlers, wartet das Laden eines Formulars. bis das Versprechen erfüllt wird, aber nur bis zu 10 Sekunden. Durch diese Begrenzung wird sichergestellt, dass das Formular innerhalb einer angemessenen Zeitspanne geladen wird.

Hinweis

Können Sie uns Ihre Präferenzen für die Dokumentationssprache mitteilen? Nehmen Sie an einer kurzen Umfrage teil. (Beachten Sie, dass diese Umfrage auf Englisch ist.)

Die Umfrage dauert etwa sieben Minuten. Es werden keine personenbezogenen Daten erhoben. (Datenschutzbestimmungen).