CreateUserWizard控件的一些功能和属性

CreateUserWizard控件

1.功能

CreateUserWizard控件提供用于创建新网站用户帐户的用户界面。该对象与网站的用户数据存储区进行通信，以便在数据存储区中创建新用户帐户。默认情况下，CreateUserWizard 控件将接受网站访问者的用户名和密码。

2.属性

CreateUserWizard控件的常用属性及说明如表1所示。

                    表1 CreateUserWizard控件常用属性及说明

名称	说明
ActiveStep	获取WizardSteps集合中当前显示给用户的步骤
ActiveStepIndex	获取或设置当前向用户显示的步骤
Answer	获取或设置最终用户对密码恢复确认问题的答案
AnswerRequiredErrorMessage	获取或设置由于用户没有输入密码确认问题的答案而显示的错误信息
AutoGeneratePassword	获取或设置用于指示是否自动为新用户帐户生成密码的值
CancelButtonImageUrl	获取或设置为“取消”按钮显示的图像的URL
CancelButtonText	获取或设置为“取消”按钮显示的文本标题
CancelButtonType	获取或设置呈现为“取消”按钮的按钮类型
CancelDestinationPageUrl	获取或设置在用户单击“取消”按钮时将定向到的 URL
CompleteStep	获取对最终用户帐户创建步骤的引用
CompleteSuccessText	获取或设置网站用户帐户创建成功后所显示的文本
ConfirmPassword	获取用户输入的第二个密码
ConfirmPasswordCompareErrorMessage	获取或设置当用户在密码文本框和确认密码文本框中输入两个不同的密码时所显示的错误信息
ConfirmPasswordLabelText	获取或设置第二个密码文本框的标签文本
ConfirmPasswordRequiredErrorMessage	获取或设置当用户将确认密码文本框留空时所显示的错误信息
ContinueButtonImageUrl	获取或设置最终用户帐户创建步骤上的“继续”按钮所用图像的URL
ContinueDestinationPageUrl	获取或设置在用户单击成功页上的“继续”按钮后将看到的页的 URL
CreateUserButtonText	获取或设置在“创建用户”按钮上显示的文本标题
CreateUserButtonType	获取或设置呈现为“创建用户”按钮的按钮类型
CreateUserStep	获取对用户帐户创建步骤的模板的引用
DuplicateEmailErrorMessage	获取或设置当用户输入成员资格提供程序中已使用的电子邮件地址时所显示的错误信息
DuplicateUserNameErrorMessage	获取或设置当用户输入成员资格提供程序中已使用的用户名时所显示的错误信息
EditProfileIconUrl	获取或设置图像的 URL，该图像显示在指向“用户配置文件编辑”页的链接旁
EditProfileText	获取或设置指向“用户配置文件编辑”页的链接的文本标题
EditProfileUrl	获取或设置“用户配置文件编辑”页的 URL
Email	获取或设置用户输入的电子邮件地址
EmailRegularExpression	获取或设置用于验证提供的电子邮件地址的正则表达式
EmailRegularExpressionErrorMessage	获取或设置当输入的电子邮件地址不满足站点的电子邮件地址条件时所显示的错误信息
EmailRequiredErrorMessage	获取或设置由于用户未在电子邮件文本框中输入电子邮件地址而向用户显示的错误信息
EnableTheming	获取或设置一个值，该值指示是否对此控件应用主题
ErrorMessageStyle	获取一个对样式属性集合的引用，这些样式属性用于定义错误信息的外观
FinishDestinationPageUrl	获取或设置当用户单击“完成”按钮时将重定向到的 URL
HeaderText	获取或设置为在控件上的标题区域显示的文本标题
HelpPageIconUrl	获取或设置显示在帮助页链接旁的图像的 URL
HelpPageUrl	获取或设置“帮助”页的 URL
InvalidAnswerErrorMessage	获取或设置密码恢复答案无效时所显示的消息
InvalidEmailErrorMessage	获取或设置输入的电子邮件地址无效时所显示的消息
InvalidPasswordErrorMessage	获取或设置输入的密码无效时所显示的消息
InvalidQuestionErrorMessage	获取或设置输入的密码恢复问题无效时所显示的消息
MailDefinition	获取一个对属性集合的引用，这些属性用于定义发送给新用户的电子邮件的特征
MembershipProvider	获取或设置为创建用户帐户而调用的成员资格提供程序
Password	获取用户输入的密码
PasswordHintStyle	获取一个对属性集合的引用，这些属性用于定义描述密码要求的文本的外观
PasswordLabelText	获取或设置密码文本框的标签文本
PasswordRegularExpression	获取或设置用于验证提供的密码的正则表达式
Question	获取或设置用户输入的密码恢复确认问题
QuestionRequiredErrorMessage	获取或设置由于用户未输入密码确认问题而显示的错误信
RequireEmail	获取或设置一个值，该值指示网站用户是否必须填写电邮件地址
StepNextButtonImageUrl	获取或设置为“下一步”按钮显示的图像的 URL
StepNextButtonStyle	获取一个对 Style 对象的引用，该对象定义“下一步”按钮的设置
StepNextButtonText	获取或设置为“下一步”按钮显示的文本标题
StepNextButtonType	获取或设置呈现为“下一步”按钮的按钮类型
StepPreviousButtonImageUrl	获取或设置为“上一步”显示的图像的 URL
StepPreviousButtonStyle	获取一个对 Style 对象的引用，该对象定义“上一步”按钮的设置
StepPreviousButtonText	获取或设置为“上一步”按钮显示的文本标题
StepPreviousButtonType	获取或设置呈现为“上一步”按钮的按钮类型
StepStyle	获取一个对 Style 对象的引用，该对象定义
Style	获取将在Web服务器控件的外部标记上呈现为样式属性的文本属性的集合
TabIndex	获取或设置 Web 服务器控件的选项卡索引
TemplateControl	获取或设置对包含该控件的模板的引用
TemplateSourceDirectory	获取包含当前服务器控件的 Page 或 UserControl 的虚拟目录
TextBoxStyle	获取一个对属性集合的引用，这些属性用于定义文本框控件的外观
TitleTextStyle	获取一个对属性集合的引用，这些属性用于定义标题的外观
ToolTip	获取或设置当鼠标指针悬停在 Web 服务器控件上时显示的文本
UnknownErrorMessage	获取或设置当成员资格提供程序返回未定义的错误时所显示的错误信息
UserName	获取或设置用户输入的用户名
UserNameLabelText	获取或设置“用户名”文本框的标签文本
UserNameRequiredErrorMessage	获取或设置当用户名文本框留空时所显示的错误信息
ValidatorTextStyle	获取对 Style 对象的引用，该对象允许您设置验证错误信息的外观
Visible	获取或设置一个值，该值指示服务器控件是否作为 UI 呈现在页上

下面对比较重要的属性进行详细介绍。

（1）ActiveStep属性

此属性获取WizardSteps集合中当前显示给用户的步骤。

语法：

 

public WizardStepBase ActiveStep { get; }

属性值：

ActiveStep属性返回当前显示在Wizard控件中的WizardStepBase对象。ActiveStep属性是只读的；但可以使用ActiveStep属性访问当前 WizardStepBase对象的属性。使用 ActiveStepIndex 属性可动态地将ActiveStep更改为不同的WizardStepBase 对象。或者，还可以使用MoveTo方法动态设置ActiveStep属性。

（2）Answer属性

此属性获取或设置最终用户对密码恢复确认问题的答案。

语法：

 

public virtual string Answer { get; set; }

属性值：

最终用户对密码恢复确认问题的答案。默认值为空字符串("")。

（3）ContinueDestinationPageUrl属性

此属性获取或设置在用户单击成功页上的“继续”按钮后，将看到的页的URL。

语法：

 

public virtual string ContinueDestinationPageUrl { get; set; }

属性值：

目标页的URL。默认为Empty。

    说明：ContinueDestinationPageUrl属性包含用户在您的站点上成功完成注册后将看到的网页的URL。通过设置ContinueDestinationPageUrl属性，可以控制新注册的用户将看到的第一个页面。当ContinueDestinationPageUrl属性 Empty且用户单击“继续”按钮后，该页将刷新并清除表单中的所有值。

例如，注册完成后，单击【继续】按钮跳转到登录页，只需要在CreateUserWizard控件的属性窗口将ContinueDestinationPageUrl属性设为登录页的URL,，代码如下。

CreateUserWizard1.ContinueDestinationPageUrl = "~/Default1.aspx";

（4）DuplicateEmailErrorMessage属性

此属性获取或设置，当用户输入成员资格提供程序中已使用的电子邮件地址时，所显示的错误信息。

语法：

 

public virtual string DuplicateEmailErrorMessage { get; set; }

属性值：

当用户输入成员资格提供程序中已使用的电子邮件地址时，所显示的错误信息。默认值为“您输入的电子邮件地址已在使用中。请另输入一个电子邮件地址。”控件的默认文本根据服务器当前的区域设置进行本地化。

（5）DuplicateUserNameErrorMessage属性

此属性获取或设置当用户输入成员资格提供程序中已使用的用户名时所显示的错误信息。

语法：

 

public virtual string DuplicateUserNameErrorMessage { get; set; }

属性值：

当用户输入成员资格提供程序中已有的用户名时所显示的错误信息。默认值为“请另输入一个用户名。”控件的默认文本根据服务器当前的区域设置进行本地化。

（6）EmailRegularExpression属性

此属性获取或设置用于验证提供的电子邮件地址的正则表达式。

语法：

 

public virtual string EmailRegularExpression { get; set; }

属性值：

一个字符串，该字符串包含用于验证电子邮件地址的正则表达式。默认值为空字符串("")。

（7）FinishDestinationPageUrl属性

此属性获取或设置当用户单击“完成”按钮时将重定向到的URL。

语法：

 

public virtual string FinishDestinationPageUrl { get; set; }

属性值：

当用户单击 Wizard上的“完成”按钮时，将重定向到的URL。默认值为空字符串("")。

    说明：FinishDestinationPageUrl 属性指定在用户单击Wizard控件上的“完成”按钮时将显示的步骤。无法通过主题或样式表主题设置此属性。

（8）HelpPageUrl属性

此属性获取或设置“帮助”页的URL。

语法：

 

public virtual string HelpPageUrl { get; set; }

属性值：

“帮助”页的URL。默认值为空字符串("")。

（9）MailDefinition属性

此属性获取一个对属性集合的引用，这些属性用于定义发送给新用户的电子邮件的特征。

语法：

 

public MailDefinition MailDefinition { get; }

属性值：

一个对MailDefinition 对象的引用，该对象定义了发送给新用户的电子邮件。

（10）PasswordRegularExpression属性

此属性获取或设置用于验证提供的密码的正则表达式。

语法：

 

public virtual string PasswordRegularExpression { get; set; }

属性值：

一个字符串，该字符串包含用于验证提供的密码的正则表达式。默认值为空字符串 ("")。

    说明：使用PasswordRegularExpression属性可以定义密码的要求，这些密码用于验证网站上的用户。密码要求常用于确保用户在密码中包含除字母之外的符号，以使攻击者更难猜出密码。

例如，要求用户输入的密码多于6个字符，至少包含一个数字，或至少包含一个特殊字符（非字母数字字符）。代码如下：

 

CreateUserWizard1.PasswordRegularExpression="@"(?=.{6,})(?=(.*\d){1,})(?=(.*\W){1,})";

（11）RequireEmail属性

此属性获取或设置一个值，该值指示网站用户是否必须填写电子邮件地址。

语法：

 

public virtual bool RequireEmail { get; set; }