CreateUserWizard控件的详细使用说明(如何使用CreateUserWizard控件)

http://www.cn-web.com/cnweb/0/160/article/ CreateUserWizard控件属性非常多，如何使用CreateUserWizard控件： CreateUserWizard控件会输出一个用户注册表单。如果用户成功提交了该表单，那么一个新用户将添加到网站中。在后台，CreateUserWizard控件使用ASP.NET Membership来创建新用户。 CreateUserWizard控件支持大量的属性（由于属性实在太多，因此不再一一列举），通过这些属性我们可以修改该控件的外观和行为。例如，代码清单1-12中的页面使用了CreateUserWizard控件的几个属性来自定义控件的外观输出。 代码清单1-12 ShowCreateUserWizard.aspx

代码清单1-12中的CreateUserWizard控件通过CSS进行了定制（见图1-6）。需要注意的是，该控件的ContinueDestinationPageUrl属性被设置为了"~/Default.aspx"。当用户注册成功后，将会被重定向到该Default.aspx页面。 图1-6 定制CreateUserWizard控件 注解 我们可以通过微软.NET Framework SDK 2.0 文档来了解CreateUserWizard控件所支持的完整属性列表。 1.3.1 配置自定义用户表单字段 在默认情况下，CreateUserWizard控件将会显示下列表单字段： q Username q Password q Confirm Password q Email q Security Question q Security Answer 以上是默认提供的表单项，最后三项是可选的。 如果不需要用户输入电子邮件地址或安全问题提示及答案，那么就需要修改默认的Membership接口提供器。代码清单1-13中的Web配置文件，配置了CreateUserWizard控件是否需要电子邮件地址和安全问题提示及答案表单项。 代码清单1-13 Web.Config

如果将代码清单1-13中的Web配置文件加入应用程序中，那么CreateUserWizard控件将不会输出安全问题提示及答案表单项。但其仍会输出一个电子邮件表单项。如果连电子邮件地址表单项也不需要输出，那么还需要做一些额外的操作。必须将CreateUserWizard控件的RequireEmail属性设置为false。 如果将代码清单1-14中的页面加入使用代码清单1-13中Web配置文件的应用程序中，那么电子邮件地址、安全问题提示和安全问题答案表单项就都不会显示（见图1-7）。 图1-7 精简版的用户注册表单 代码清单1-14 CreateUserWizardShort.aspx

注意 当Membership接口提供器的requireUniqueEmail属性被设为true值时，请不要将CreateUserWizard控件的RequireEmail属性设为false值。换句话说，就是在不给用户提供电子邮件地址输入表单项时，不要让用户提供电子邮件地址。 1.3.2 发送已创建用户电子邮件通知 可以通过配置CreateUserWizard控件，使其在注册新用户后自动地发送电子邮件通知。例如，可以向该用户电子邮件地址发送一封包含了新注册用户的用户名和密码的通知邮件。 注意 通过互联网来发送包含用户密码的未加密电子邮件是非常危险的。然而，这样发送包含密码的注册确认邮件也是目前很普遍的行为。 代码清单1-15中的页面包含MailDefinition属性，该属性用来表示当用户成功注册后，向该用户发送的确认电子邮件的定义。 代码清单1-15 CreateUserWizardEmail.aspx

该MailDefinition类支持下列属性： q BodyFileName——用于指定电子邮件通知正文内容的文件路径； q CC——用于表示抄送该电子邮件的邮件地址； q EmbeddedObjects——用于在电子邮件中嵌入对象，例如图片、文档等； q From——用于指定电子邮件的来源邮件地址； q IsBodyHtml——用于指示是否发送HTML格式的电子邮件； q Priority——用于指定电子邮件的发送优先级。可能取值为Hight、Low和Normal； q Subject——用于指定电子邮件的标题。 在代码清单1-15中，关联到CreateUserWizard控件上的MailDefinition类将会通过电子邮件发送代码清单1-16中的文本文件内容。 代码清单1-16 Register.txt Thank you for registering! Here is your new username and password: username:

password:

这里需要注意的是，代码清单1-16中的电子邮件通知正文中包含了两个特殊的表达式：

和

。当发送电子邮件时，系统会自动地将用户的注册用户名和密码替换到该表达式中（见图1-8）。 图1-8 收到的注册电子邮件通知 注解 我们也可以在电子邮件通知中，发送通过Membership提供器进行加密或散列过的用户密码。 MailDefinition类使用Web配置文件中smtp节点的定义来配置电子邮件服务器端。例如，在代码清单1-17 的Web配置文件中，示例了如何在互联网信息服务器端（IIS）上配置本地SMTP邮件服务器端，以供MailDefinition类发送电子邮件使用（我们可以从管理工具文件夹中打开IIS管理器，启用本地SMTP服务）。 代码清单1-17 Web.Config

如果要连接位于另一台服务器端上的电子邮件服务器端，可以使用代码清单1-18中的Web配置文件。代码清单1-18中，节点smtp的定义中包含了一个用于指定电子邮件主机地址、用户名和密码的network节点。 代码清单1-18 Web.Config

注解 如果要自定义CreateUserWizard控件发送的电子邮件通知的内容，那么我们可以处理CreateUserWizard控件提供的事件SendingMail。详细信息见1.3.3节中的页面CreateUserWizard- CodeConfirmation.aspx。 1.3.3 用户自动重定向来源页面 当用户通过页面Login.aspx中的表单成功登录后，将会自动地重定向回其请求的来源页面。另外，CreateUserWizard控件并不能自动地重定向到任何位置。如果你希望CreateUserWizard控件能像Login控件那样工作，则需要编写一定的代码。 代码清单1-19中的Login控件包含了一个用于连接到用户注册页面CreateUserWizard- Returen.aspx上的链接。在Page_Load()事件处理函数中，查询字符串参数ReturnUrl将被添加到该注册页面的链接上。 代码清单1-19 LoginReturn.aspx

在使用代码清单1-19中的页面之前，需要将该页面重命名为Login.aspx。如果未认证用户访问了需要认证才能访问的页面，那么该用户访问请求就会被自动重定向到页面Login.aspx上，并且ReturnUrl参数也会自动添加到页面Login.aspx的访问路径之后。 代码清单1-20中的页面包含了一个CreateUserWizard控件，以及一个名为Page_Load()的事件处理函数。查询字符串参数ReturnUrl的值用来指定重定向时用户将会返回的原始请求页。 代码清单1-20 CreateUserWizardReturn.aspx

1.3.4 自动生成密码 有一部分网站在进行注册时候需要多个步骤。例如，要在eBay上注册一个新账号就必须要完成下列步骤： (1) 仔细填写完成用户注册表单； (2) 接收包含注册认证码的电子邮件； (3) 将认证码填入指定表单中进行确认。 使用这样的注册方式可以检验用户输入的电子邮件地址是否有效。如果是无效的电子邮件地址，他就不能接收到注册认证码。 要实现这样的注册方案，就必须了解CreateUserWizard控件的下列三个属性： q AutoGeneratePassword——用于指定控件是否自动产生新密码； q DisableCreatedUser——用于禁止通过控件创建新用户账号； q LoginCreateUser——用于在自动登录中保护新用户。 同时还可以发送两种类型的注册确认电子邮件通知。其一，可以自动生成新密码并将该密码发送给进行注册的用户。这种方式需要启用控件的AutoGeneratePassword属性，同时禁用其LoginCreateUser属性。 另外一种是让用户自己输入密码，然后在电子邮件的确认通知中发送特别的认证码。而这需要启用控件的DisableCreatedUser属性，并同时禁用LoginCreateUser属性。下面让我们分别对这些方案进行试验。 代码清单1-21中的页面包含了CreateUserWizard控件，但该控件并不输出密码表单项。该控件启用了AutoGeneratePassword属性，同时禁用了LoginCreateUser属性。在填写完成由CreateUserWizard控件输出的用户注册表单后，点击Continue按钮将会打开页面Login.aspx。 代码清单1-21 CreateUserWizardPasswordConfirmation.aspx

注意 在启用了CreateUserWizard控件自动生成密码功能后，请不要再设置Membership接口提供器的passwordStrengthRegularExpression属性。 代码清单1-21中的CreateUserWizard控件发送的电子邮件通知将会包含代码清单1-22中的内容。 代码清单1-22 PasswordConfirmation.htm

Your new password is

. 代码清单1-22中的电子邮件通知中包含了自动生成的密码。当新用户收到了自动生成的用户密码后，便可以在应用程序的Login.aspx页面中输入该密码进行登录。 在另一种使用场景中，用户可以自己选择密码。然而，该用户的账号在其输入注册验证码进行确认前是不能使用的。 代码清单1-23中的CreateUserWizard控件启用了其DisableCreateUser属性，并同时禁用了LoginCreateUser属性。 代码清单1-23 CreateUserWizardCodeConfirmation.aspx

需要注意的是，代码清单1-23中的页面包含了一个SendingMail事件处理函数。注册验证码是通过Membership接口提供器关联到每个新用户上的唯一键值（本示例中使用的是GUID）。该验证码在电子邮件通知发送前将输入到电子邮件中。该电子邮件通知的内容包含在代码清单1-24中。 代码清单1-24 CodeConfirmation.htm

, your confirmation code is

在填写完CreateUserWizard控件输出的表单后，便可以通过点击Continue按钮来打开页面ConfirmCode.aspx（见图1-9）。 图1-9 输入验证码 代码清单1-25 ConfirmCode.aspx

Enter the confirmation code that you received by email.

当用户在特定的表单中输入了正确的用户名和相应的认证码后，其账号将正式启用。MembershipUser.IsApproved属性需要设置为true，然后再使用Membership.UpdateUser()方法来保存更新的用户信息。 1.3.5 在CreateUserWizard控件中使用模板 如果需要对CreateUserWizard控件输出表单的外观进行自定义，那么我们可以为CreateUserWizard和CompleteWizardStep控件创建模板。例如，在代码清单1-26 的页面中就使用了一个下拉列表框来显示安全提示问题的选项（见图1-10）。 图1-10 利用模板来自定义CreateUserWizard控件 代码清单1-26 CreateUserWizardTemplate.aspx

Register

Your account was successfully created.

在CreateUserWizardStep控件中，可以添加使用下列特定ID的控件： q UserName q Password q Email q ConfirmPassword q Question q Answer q ErrorMessage 当然，也可以加入任何其他所需的控件。例如，当新用户注册和将信息保存到特定的数据库表中时，会需要询问一些额外的信息（见1.3.6节）。 在CreateUserWizardStep控件中，还可以添加包含了下列CommandName属性值的Button控件： q CreateUser q Cancel 1.3.6 在CreateUserWizard控件中添加注册步骤 由于CreateUserWizard控件继承自Wizard基控件。也就是说，在使用CreateUserWizard控件时，可以使用所有Wizard控件支持的属性。尤其是还可以通过添加额外的向导步骤来扩充该CreateUserWizard控件。 例如，假设需要新用户分别输入自己的姓和名。代码清单1-27中的页面包含了一个额外的向导步骤，该步骤包含了填写姓和名的表单项。 代码清单1-27 CreateUserWizardExtra.aspx

代码清单1-27中的页面包含了CreatedUser事件的处理函数，创建新用户时将触发该事件。该事件处理函数会将新用户的姓和名添加到数据库表UserProfilesDB中。 文章来源(WEB开发技术知识库)：http://www.cn-web.com/cnweb/0/160/article/