Freigeben über

CreateUserWizard.OnCreatingUser(LoginCancelEventArgs) Methode

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Löst das CreatingUser Ereignis aus, bevor der Mitgliedschaftsanbieter aufgerufen wird, um das neue Benutzerkonto zu erstellen.

protected:
 virtual void OnCreatingUser(System::Web::UI::WebControls::LoginCancelEventArgs ^ e);
protected virtual void OnCreatingUser(System.Web.UI.WebControls.LoginCancelEventArgs e);
abstract member OnCreatingUser : System.Web.UI.WebControls.LoginCancelEventArgs -> unit
override this.OnCreatingUser : System.Web.UI.WebControls.LoginCancelEventArgs -> unit
Protected Overridable Sub OnCreatingUser (e As LoginCancelEventArgs)

Parameter

e
LoginCancelEventArgs

A LoginCancelEventArgs containing the event data.

Beispiele

Im folgenden Codebeispiel wird ein benutzerdefiniertes CreateUserWizard Steuerelement definiert, das die OnCreatingUser Methode verwendet, um die UserName Eigenschaft in Kleinbuchstaben zu erstellen.

using System;
using System.Web;
using System.Web.UI.WebControls;
using System.Security.Permissions;

namespace Samples.AspNet.CS.Controls {
  [AspNetHostingPermission(System.Security.Permissions.SecurityAction.Demand,Level = AspNetHostingPermissionLevel.Minimal)]
  [AspNetHostingPermission(System.Security.Permissions.SecurityAction.InheritanceDemand,Level = AspNetHostingPermissionLevel.Minimal)]
  public class CustomCreateUserWizard : CreateUserWizard {

    protected override void OnCreatingUser(LoginCancelEventArgs e) {
      this.UserName.ToLower();
      base.OnCreatingUser(e);
    }
  }
}

Imports System.Web
Imports System.Web.UI.WebControls
Imports System.Security.Permissions

Namespace Samples.AspNet.VB.Controls
  <AspNetHostingPermission(System.Security.Permissions.SecurityAction.Demand, Level:=AspNetHostingPermissionLevel.Minimal)> _
  <AspNetHostingPermission(System.Security.Permissions.SecurityAction.InheritanceDemand, Level:=AspNetHostingPermissionLevel.Minimal)> _
  Public Class CustomCreateUserWizard
    Inherits CreateUserWizard
    
    Overloads Sub OnCreatingUser(ByVal e As LoginCancelEventArgs)
      Me.UserName.ToLower()
      MyBase.OnCreatingUser(e)
    End Sub    
    
  End Class
End Namespace

Das folgende Codebeispiel veranschaulicht eine Webseite, die die CustomCreateUserWizard.

<%@ Page Language="C#"%>
<%@ Import namespace="Samples.AspNet.CS.Controls" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

  void Page_Load(object sender, EventArgs e)
  {
    CustomCreateUserWizard createUser = new CustomCreateUserWizard();
    Placeholder1.Controls.Add(createUser);
  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>CreateUserWizard.OnCreatingUser sample</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:placeholder id="Placeholder1" runat="server">
      </asp:placeholder>
    </div>
    </form>
</body>
</html>

<%@ Page Language="VB"%>
<%@ Import namespace="Samples.AspNet.VB.Controls" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
  
  Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
    Dim createUser As New CustomCreateUserWizard
    Placeholder1.Controls.Add(createUser)
  End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>CreateUserWizard.OnCreatingUser sample</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:placeholder id="Placeholder1" runat="server">
      </asp:placeholder>
    </div>
    </form>
</body>
</html>

Hinweise

Verwenden Sie die OnCreatingUser Methode, um alle erforderlichen Verarbeitungen vor dem Senden der neuen Benutzerinformationen an die CreateUser Methode des mitgliedschaftsanbieters zu senden, der in der MembershipProvider Eigenschaft angegeben ist. Sie können beispielsweise das Benutzernamenfeld auf alle Kleinbuchstaben festlegen oder die E-Mail-Adresse mit einer Liste eingeschränkter Adressen vergleichen, bevor Sie die Erstellung des Benutzerkontos zulassen.

Wenn Sie die Anforderung zum Erstellen des neuen Benutzerkontos abbrechen müssen, legen Sie die Cancel Eigenschaft des LoginCancelEventArgs Objekts fest, das als e Parameter übergeben wird.true

Das Auslösen eines Ereignisses ruft den Ereignishandler über einen Delegaten auf. Weitere Informationen finden Sie unter Behandeln und Auslösen von Ereignissen.

Mit der OnCreatingUser Methode können abgeleitete Klassen auch das Ereignis behandeln, ohne einen Delegaten anzufügen. Dies ist die bevorzugte Technik für die Behandlung des Ereignisses in einer abgeleiteten Klasse.

Hinweise für Vererber

Achten Sie darauf, beim Überschreiben OnCreatingUser(LoginCancelEventArgs) in einer abgeleiteten Klasse die Methode der Basisklasse OnCreatingUser(LoginCancelEventArgs) aufzurufen, damit registrierte Delegates das Ereignis empfangen.

Gilt für:

Weitere Informationen