Freigeben über

Formular OnLoad-Ereignis

  • Artikel

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 Methoden formContext.ui.addOnLoad und formContext.ui.removeOnLoad , um Ereignishandler für dieses Ereignis zu verwalten.

Anmerkung

Steuerelemente in einem Formular sind möglicherweise nicht bereit, wenn ein OnLoad Formularereignis eintritt. Verwenden Sie das OnLoad -Ereignis des Steuerelements, um zu warten, bis es bereit ist. Weitere Informationen: Ereignishandlerfunktion über die Benutzeroberfläche zum Ereignis hinzufügen oder entfernen

Asynchroner OnLoad-Ereignishandlersupport

Der OnLoad Ereignishandler kann auf die Erfüllung von von Ereignishandlern zurückgegebenen Versprechen warten, bevor er ein Formular lädt, das ein OnLoad asynchrones („async“) Ereignis zulässt. 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 auf die Rückgabe eines Promise pro Handler. Wenn mehrere Promises erforderlich sind, wird empfohlen, alle Promises in der Promise.all() Methode mit Verpacken zu verknüpfen und das einzelne resultierende Promise 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. Auswählen die App und dann Auswählen ... (Auslassungspunkte). Wählen Sie Bearbeiten.

  5. Auswählen Einstellungen in der Befehlsleiste.

  6. Wenn das Dialogfeld geöffnet wird, Auswählen Funktionen.

  7. Aktivieren Sie den Asynchronen Onload-Handler.

  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.

Ereignisse (Client-API-Referenz)
Ereignisse in Formularen und Rastern in modellgesteuerten Apps