CreateSubSession(String, String, UserRoles):IOnionSession

Mittels dieser Methode können neue Sitzungen erstellt werden. Diese Sitzungen basieren auf der bereits bestehenden Sitzung.

Der Unterschied zu dieser Sitzung und zu einer Sitzung, die mittels der Klasse OnionSession erstellt worden ist, ist dass die Berechtigungen bei dieser Sitzung durch die Hauptsitzung eingeschränkt werden. Bei einer SubSession werden die Daten mittels des Benutzers der Hauptsitzung abgerufen und werden im Nachhinein für den Benutzer der neu erstellten Sitzung gegebenenfalls weiter gefiltert. So kann je nach Berechtigungen des Benutzers, der in der Hauptsitzung angemeldet ist, die SubSession von Beginn an eingeschränkt sein.

Der angegebene Benutzer muss den angegebenen Benutzerrollen entsprechen, sonst schlägt die Validierung des Benutzers fehl und es wird keine neue Sitzung erstellt.

Sollte die Verbindung unterbrochen sein, so wird eine Ausnahme vom Typ InvalidSessionException ausgelöst.

Desweiteren muss der Benutzer der Hauptsitzung über die Rolle SessionHost verfügen, andernfalls wird eine Ausnahme vom Typ RequiresSessionHostException ausgelöst.

Parameter

userName

Typ: System.String

Dieser Parameter ist der Benutzername des Benutzers, für welchen eine neue Sitzung erstellt werden soll.

Wird als Wert NULL angegeben, wird eine Ausnahme vom Typ System.ArgumentNullException ausgelöst.

password

Typ: System.String

Dieser Parameter ist das Kennwort des Benutzers, für welchen eine neue Sitzung erstellt werden soll.

Wird als Wert NULL angegeben, wird eine Ausnahme vom Typ System.ArgumentNullException ausgelöst.

expectedRoles

Typ: UserRoles

Dieser Parameter enthält die Rollen, die der angegebene Benutzer besitzen muss, damit die Sitzung erstellt werden kann.