WebSecurity - CreateUserAndAccount()
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
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-Objekt Weitere Erweiterungen