CreateUserErrorEventArgs クラス

.NET Framework クラス ライブラリ リファレンス

CreateUserErrorEventArgs クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

CreateUserError イベントのデータを提供します。

名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Class CreateUserErrorEventArgs
    Inherits EventArgs

Visual Basic (使用法)

Dim instance As CreateUserErrorEventArgs

C#

public class CreateUserErrorEventArgs : EventArgs

C++

public ref class CreateUserErrorEventArgs :
 public EventArgs

J#

public class CreateUserErrorEventArgs extends
 EventArgs

JScript

public class CreateUserErrorEventArgs extends
 EventArgs

解説

A CreateUserWizard コントロールで新しいユーザーを作成しようとしたが失敗すると、CreateUserError イベントが発生します。CreateUserErrorEventArgs クラスには、発生したエラーに対応する MembershipCreateStatus 列挙値を示す CreateUserError プロパティが用意されています。

使用例

次の例では、CreateUserError イベントが発生すると、CreateUserErrorEventArgs オブジェクトの CreateUserError プロパティが、Label コントロール Label1 に表示され、CreateUserError イベントが発生した理由が提供されます。

Visual Basic

Partial Class CreateUserWizardErrorvb_aspx
    Inherits System.Web.UI.Page

    Protected Sub OnCreateUserError(ByVal
 sender As Object, ByVal
 e As System.Web.UI.WebControls.CreateUserErrorEventArgs)

        Select Case (e.CreateUserError)

            Case MembershipCreateStatus.DuplicateUserName
                Label1.Text = "Username already exists. Please
 enter a different user name."


            Case MembershipCreateStatus.DuplicateEmail
                Label1.Text = "A username for that e-mail address
 already exists. Please enter a different e-mail address."


            Case MembershipCreateStatus.InvalidPassword
                Label1.Text = "The password provided is invalid.
 Please enter a valid password value."


            Case MembershipCreateStatus.InvalidEmail
                Label1.Text = "The e-mail address provided is
 invalid. Please check the value and try again."


            Case MembershipCreateStatus.InvalidAnswer
                Label1.Text = "The password retrieval answer provided
 is invalid. Please check the value and try again."


            Case MembershipCreateStatus.InvalidQuestion
                Label1.Text = "The password retrieval question
 provided is invalid. Please check the value and try again."


            Case MembershipCreateStatus.InvalidUserName
                Label1.Text = "The user name provided is invalid.
 Please check the value and try again."


            Case MembershipCreateStatus.ProviderError
                Label1.Text = "The authentication provider returned
 an error. Please verify your entry and try again. If the problem persists, please
 contact your system administrator."


            Case MembershipCreateStatus.UserRejected
                Label1.Text = "The user creation request has been
 canceled. Please verify your entry and try again. If the problem persists, please
 contact your system administrator."

            Case Else
                Label1.Text = "An unknown error occurred. Please
 verify your entry and try again. If the problem persists, please contact your system
 administrator."

        End Select

    End Sub

End Class

C#

public partial class CreateUserWizardErrorcs_aspx
 : System.Web.UI.Page
{
    protected void OnCreateUserError(object
 sender, System.Web.UI.WebControls.CreateUserErrorEventArgs e)
    {
        
        switch (e.CreateUserError)
        {
            case MembershipCreateStatus.DuplicateUserName:
                Label1.Text = "Username already exists. Please enter a different
 user name.";
                break;

            case MembershipCreateStatus.DuplicateEmail:
                Label1.Text = "A username for that e-mail
 address already exists. Please enter a different e-mail address.";
                break;

            case MembershipCreateStatus.InvalidPassword:
                Label1.Text = "The password provided is invalid. Please enter
 a valid password value.";
                break;

            case MembershipCreateStatus.InvalidEmail:
                Label1.Text = "The e-mail address provided is invalid. Please
 check the value and try again.";
                break;

            case MembershipCreateStatus.InvalidAnswer:
                Label1.Text = "The password retrieval answer provided is invalid.
 Please check the value and try again.";
                break;

            case MembershipCreateStatus.InvalidQuestion:
                Label1.Text = "The password retrieval question provided is invalid.
 Please check the value and try again.";
                break;

            case MembershipCreateStatus.InvalidUserName:
                Label1.Text = "The user name provided is invalid. Please check
 the value and try again.";
                break;

            case MembershipCreateStatus.ProviderError:
                Label1.Text = "The authentication provider returned an error.
 Please verify your entry and try again. If the problem persists,
 please contact your system administrator.";
                break;

            case MembershipCreateStatus.UserRejected:
                Label1.Text = "The user creation request has been canceled.
 Please verify your entry and try again. If the problem persists,
 please contact your system administrator.";
                break;

            default:
                Label1.Text = "An unknown error occurred. Please verify your
 entry and try again. If the problem persists, please contact
 your system administrator.";
                break;
        }
    }
}

前の例の実行に使用できる .aspx ファイルを次に示します。

Visual Basic

<%@ Page Language="VB" AutoEventWireup="false"
 CodeFile="CreateUserWizardError.vb" Inherits="CreateUserWizardErrorvb_aspx"
 %>

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

<html  >
<body>
    <form id="form1" runat="server">
      <h3>CreateUserWizardError Example</h3>
      <asp:CreateUserWizard id="CreateUserWizard1"
 
        runat="server" 
        oncreateusererror="OnCreateUserError">
        <WizardSteps>
                <asp:CreateUserWizardStep ID="CreateUserWizardStep1"
 runat="server">
                </asp:CreateUserWizardStep>
                <asp:CompleteWizardStep ID="CompleteWizardStep1"
 runat="server">
                </asp:CompleteWizardStep>
            </WizardSteps>
      </asp:CreateUserWizard>
      <asp:Label id="Label1" 
        runat="server">
      </asp:Label>
    </form>
  </body>
</html>

C#

<%@ Page Language="C#" CodeFile="CreateUserWizardError.cs"
 Inherits="CreateUserWizardErrorcs_aspx" %>

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

<html  >
  <body>
    <form id="form1" runat="server">
      <h3>CreateUserWizardError Example</h3>
      <asp:CreateUserWizard id="CreateUserWizard1" 
        runat="server" 
        oncreateusererror="OnCreateUserError">
        <WizardSteps>
                <asp:CreateUserWizardStep ID="CreateUserWizardStep1"
 runat="server">
                </asp:CreateUserWizardStep>
                <asp:CompleteWizardStep ID="CompleteWizardStep1" runat="server">
                </asp:CompleteWizardStep>
            </WizardSteps>
      </asp:CreateUserWizard>
      <asp:Label id="Label1" 
        runat="server">
      </asp:Label>
    </form>
  </body>
</html>

.NET Framework のセキュリティ

• AspNetHostingPermission  (ホスト環境での動作に必要なアクセス許可)。要求値 : LinkDemand。アクセス許可値 : Minimal。
• AspNetHostingPermission  (ホスト環境での動作に必要なアクセス許可)。要求値 : InheritanceDemand。アクセス許可値 : Minimal。

継承階層

System.Object
   System.EventArgs
    System.Web.UI.WebControls.CreateUserErrorEventArgs

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
CreateUserErrorEventArgs メンバ
System.Web.UI.WebControls 名前空間
CreateUserWizard
MembershipCreateStatus
CreateUserError