WebSecurity - CreateUserAndAccount()


❮ Websicherheit

Definition

Die Methode CreateUserAndAccount() erstellt ein neues Konto in der Benutzerdatenbank unter Verwendung von Benutzername und Passwort und lässt Sie optional angeben, ob der Benutzer das Konto ausdrücklich bestätigen muss.


C#- und VB-Syntax

WebSecurity.CreateUserAndAccount(username, password, propertyValues, requireConfirmation)

Parameter

Parameter Type Description
userName String The user name
password String The user password
propertyValues Object A dictionary that contains additional user attributes
requireConfirmation Boolean true if the account must be confirmed using the token return value, default is false.

Rückgabewert

Type Description
String A token that can be sent to the user to confirm the account.

Bemerkungen

Die Methode CreateUserAndAccount() erstellt einen neuen Eintrag in der Benutzerprofiltabelle und dann einen entsprechenden Eintrag in der Mitgliedschaftstabelle in der WebSecurity-Datenbank .

Sie können für den Parameter requireConfirmationToken true übergeben, um zu verlangen, dass das Benutzerkonto vom Benutzer bestätigt werden muss. Um das Konto zu bestätigen, erhalten Sie den Token als Rückgabewert von der Methode CreateUserAndAccount() .

Wenn Sie die Benutzerprofiltabelle manuell verwalten und nur einen Mitgliedschaftstabelleneintrag für den Benutzer erstellen möchten, rufen Sie stattdessen die Methode CreateAccount() auf .


Fehler und Ausnahmen

Jeder Zugriff auf das WebSecurity- Objekt löst eine InvalidOperationException aus , wenn:

  • Die Methode InitializeDatabaseConnection() wurde nicht aufgerufen
  • SimpleMembership ist nicht initialisiert (oder in der Website-Konfiguration deaktiviert)

Die Methode CreateUserAndAccount() löst auch eine MembershipCreateUserException aus , wenn:

  • Der Benutzername ist leer
  • Der Benutzername hat bereits ein Mitgliedskonto
  • Das Passwort ist leer
  • Das Passwort ist zu lang
  • Der Datenbankvorgang ist fehlgeschlagen

❮ Websicherheit