Method CloseApplication

CloseApplication()

Schließt die Anwendung. Der Benutzer wird gefragt, ob er die Anwendung beenden möchte. An den geöffneten Forms wird die Methode IsApplicationQuitAllowed aufgerufen und eine entsprechende Message-Box ausgegeben bzw. das Schließen der Anwendung verhindert.

Declaration

[DocfxBrowsable]
void CloseApplication()

Remarks

Diese Methode wirft intern eine Exception, die dafür sorgt, dass die gesamte Anwendung beendet wird. Dies wird auch dem Client mitgeteilt, sodass dieser ebenfalls geschlossen wird.

CloseApplication(FrameworkCloseMode)

Wird als closeMode das Flag Restart angegeben, so wird ein Neustart des Clients veranlasst. Allerdings darf ein Neustart nur unter der Bedingung ausgeführt werden, dass jedes aktuell laufende Ereignis eines der folgenden ist:

• MenuItem.OnClick
• Button.OnClick
• ImageButton.OnClick
• MessageBox-Event(Als Folge eine der oben genannten Events)

Mit aktuell laufenden Ereignissen sind auch solche Ereignisse gemeint, die als Folge einen modalen Dialog geöffnet haben.Solange der Dialog offen ist, zählt das Ereignis zu den laufenden.

Zusätzlich gibt es das Flag KeepUserLogin. Wird Restart mit diesem Flag kombiniert (bitweise Oder-Verknüpfung), so wird beim Neustart der User Token in die neue Sitzung übernommen und es ist kein erneuter Login erforderlich.

Declaration

[DocfxBrowsable]
void CloseApplication(FrameworkCloseMode closeMode)

Parameters

closeMode FrameworkCloseMode

Remarks

Diese Methode wirft intern eine Exception, die dafür sorgt, dass die gesamte Anwendung beendet wird. Dies wird auch dem Client mitgeteilt, sodass dieser ebenfalls geschlossen wird.

CloseApplication(String)

Schließt die Anwendung unmittelbar. Es wird keine weitere Prüfung durchgeführt und der Benutzer hat keine Möglichkeit die Aktion abzubrechen. Am Client wird dabei die übergebene Message ausgegeben.

Declaration

[DocfxBrowsable]
void CloseApplication(string message)

Parameters

message System.String

Die Meldung die am Client angezeigt werden soll.

Wird String.Empty übergeben, wird die Anwendung ohne Meldung beendet.

Wird null übergeben, verhält sich die Methode wie die parameterlose CloseApplication().

Remarks

Diese Methode wirft intern eine Exception, die dafür sorgt, dass die gesamte Anwendung beendet wird. Dies wird auch dem Client mitgeteilt, sodass dieser ebenfalls geschlossen wird.