Create(ISchema, String, String, Boolean):UserApplicationSettings

Ein Benutzerprofil ist ein Datenobjekt, welches in der Schemaverwaltung definiert worden ist.

Da für Benutzerprofile keine Namen vergeben werden können, ist das Alleinstellungsmerkmal das Schema, sowie ein Instanzname. Die Kombination aus Schema und Instanzname darf zusammen nur einmal pro Benutzer als Profil vorkommen. Durch diese Methode ist es möglich mehrere Benutzerprofile von einem Typ zuinstanziieren, die in verschiedenen Kontexten eines Projektes verwendet werden können. So kann beispielsweise ein Benutzerprofil definiert werden, welches Daten für ein Portal definiert. Möglicherweise gibt es verschiedene Portale, die in einer onion.net Instanz betrieben werden. So könnte für jedes Portal jeweils ein Benutzerprofil des gleichen Schemas für ein und den gleichen Benutzer instanziiert werden.

Parameter

schema

Typ: Onion.Client.ISchema

Dieser Parameter ist das Schema, welchem das Benutzerprofil folgt.

instance

Typ: System.String

Dieser Parameter gibt einen Instanznamen an. Dieser Name kann frei vergeben werden. Es sollten nur keine Leerzeichen oder Sonderzeichen verwendet werden. Als Standardname sollte "default" verwendet werden.

xmlData

Typ: System.String

Dieser Parameter enthält das Xml des Datenobjektes.

overwrite

Typ: System.Boolean

Dieser Parameter steuert, ob ein Datenobjekt überschrieben werden soll, falls es bereits ein Profil mit dem Schema und Instanznamen geben sollte.

Wird als Wert false angegeben, so wird eine Ausnahme vom Typ DataObjectAlreadyExistsException ausgelöst, falls bereits die Instanz des Schemas vorhanden sein sollte.