CreateUserWizard.OnCreatingUser(LoginCancelEventArgs) Methode

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Löst das CreatingUser-Ereignis vor dem Aufrufen des Mitgliedschaftsanbieters zum Erstellen des neuen Benutzerkontos aus.

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

Ein LoginCancelEventArgs, das die Ereignisdaten enthält.

Beispiele

Im folgenden Codebeispiel wird ein benutzerdefiniertes CreateUserWizard Steuerelement definiert, das die OnCreatingUser -Methode verwendet, um die UserName -Eigenschaft klein zu machen.

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

Im folgenden Codebeispiel wird eine Webseite veranschaulicht, die das CustomCreateUserWizardverwendet.

<%@ 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 durchzuführen, bevor Sie die neuen Benutzerinformationen an die CreateUser Methode des in der -Eigenschaft angegebenen Mitgliedschaftsanbieters MembershipProvider senden. Beispielsweise können Sie das Feld Benutzername 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 als e Parameter übergebenen Objekts auf fest true.

Durch das Auslösen eines Ereignisses wird der Ereignishandler über einen Delegaten aufgerufen. Weitere Informationen finden Sie unter Behandeln und Auslösen von Ereignissen.

Mit der OnCreatingUser-Methode können auch abgeleitete Klassen das Ereignis ohne Anfügen eines Delegaten behandeln. Dies ist das bevorzugte Verfahren für die Behandlung des Ereignisses in einer abgeleiteten Klasse.

Hinweise für Vererber

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

Gilt für:

Freigeben über