Ansicht
Dokumentation

ABAPRAISE_EVENT - RAISE EVENT

General Data in Customer Master   Fill RESBD Structure from EBP Component Structure  
Diese Dokumentation steht unter dem Copyright der SAP AG.

RAISE EVENT

Kurzreferenz

RAISE EVENT evt $[EXPORTING p1 = a1 p2 = a2 ...$].

Zusatz:

... EXPORTING p1 = a1 p2 = a2 ...

Wirkung

Diese Anweisung kann ausschließlich in Methoden verwendet werden und löst das Ereignis evt aus. evt ist der direkt anzugebende Name eines Ereignisses, das mit der Anweisung EVENTS bzw. CLASS-EVENTS in der gleichen Klasse, einer Oberklasse oder einem implementierten Interface deklariert sein muss.

Nach dem Auslösen des Ereignisses werden alle Ereignisbehandler ausgeführt, die mit der Anweisung SET HANDLER für das Ereignis registriert sind. Die Reihenfolge der Ausführung ist undefiniert und kann sich während der Programmausführung ändern. Nach Ausführung der Ereignisbehandler wird die Methode hinter RAISE EVENT fortgesetzt.

Zusatz

... EXPORTING  p1 = a1 p2 = a2 ...

Wirkung

Mit dem Zusatz EXPORTING müssen allen nicht-optionalen und können allen optionalen Formalparametern p1 p2 ... des Ereignisses evt Aktualparameter a1 a2 ... zugewiesen werden. Die Werte der Aktualparameter werden den Ereignisbehandlern übergeben, bei deren Definition die Formalparameter hinter dem Zusatz IMPORTING der Anweisungen $[CLASS-$] EVENTS aufgeführt sind.

Bei a1, a2, ... handelt es sich um allgemeine Ausdruckspositionen, d.h. es können neben Datenobjekten auch Funktionen und Ausdrücke als Aktualparameter übergeben werden. In diesem Fall gelten spezielle Regeln.

Hinweise

• Zur Vermeidung von endlosen Rekursionen können während der Ereignisbehandlung maximal 1023 weitere Ereignisse mit RAISE EVENT ausgelöst werden.

• Falls für einen Ereignisbehandler der Formalparameter sender definiert ist, wird dieser beim Auslösen von Instanzereignissen automatisch mit der Referenz auf das auslösende Objekt versorgt. Er darf nicht explizit hinter EXPORTING angegeben werden.

• Wenn es in einem Ereignisbehandler zu einer Ausnahme kommt, wird die Ereignisbehandlung abgebrochen. Bei einer klassenbasierten Ausnahme wird dabei die Kontrolle an den Auslöser zurückgegeben. Siehe Klassenbasierte Ausnahmen in Ereignisbehandlern.
  
  

Auslösen des Instanzereignisses e1. Dem nicht-optionalen Formalparameter p1 muss ein Aktualparameter zugeordnet werden.

Ausnahmen

Unbehandelbare Ausnahmen

• Ursache: RAISE EVENT-Anweisungen zu tief geschachtelt.
  Laufzeitfehler: RAISE_EVENT_NESTING_LIMIT
  
  

CL_GUI_FRONTEND_SERVICES - Frontend Services   PERFORM Short Reference  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 4219 Date: 20240523 Time: 132440     sap01-206 ( 71 ms )