WebSecurity - CreateUserAndAccount()


WebSecurity 对象WebSecurity-Objekt

Definition

CreateUserAndAccount()Die Methode verwendet einen Benutzernamen und ein Passwort, um ein neues Konto in der Benutzerdatenbank zu erstellen, und kann optional angeben, ob der Benutzer das Konto ausdrücklich bestätigen muss.


C# und VB-Syntax

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


Parameters

Parameters Type Beschreibung
userName String Benutzername
Passwort String Benutzerpasswort
propertyValues Objekt Ein Wörterbuch, das zusätzliche Benutzerattribute enthält
requireConfirmation Boolean Wenn das Konto mit dem Rückgabewert des Tokens bestätigt werden muss, wirdtruezurückgegeben. Standardmäßig wirdfalse。


Rückgabewert

Type Beschreibung
String Ein Token, das zur Konto-Bestätigung an den Benutzer gesendet werden kann.


Hinweise

CreateUserAndAccount()Die MethodeWebSecurityerstellt einen neuen Eintrag in der Benutzerprofiltabelle in der Datenbank und erstellt dann einen passenden Eintrag in der Mitgliedschaftstabelle.

Sie könnenrequireConfirmationTokenan den Parametertrueübergeben, um zu verlangen, dass das Konto vom Benutzer bestätigt werden muss. CreateUserAndAccount()Ruft ein Token als Rückgabewert von der Methode ab.

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


Fehler und Ausnahmen

In den folgenden Fällen führt jeglicherWebSecurity-Zugriff auf das Objekt zu einerInvalidOperationException:

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

In den folgenden Fällen löst dieCreateUserAndAccount()-Methode ebenfalls eineMembershipCreateUserException:

  • Der Benutzername ist leer.
  • Der Benutzername besitzt bereits ein Mitgliedschaftskonto.
  • Das Passwort ist leer.
  • Das Passwort ist zu lang.
  • Die Datenbankoperation ist fehlgeschlagen.

Technische Daten

Name Wert
Namespace WebMatrix.WebData
Assembly WebMatrix.WebData.dll


WebSecurity 对象WebSecurity-Objekt Weitere Erweiterungen