MembershipCreateUserException コンストラクター

リファレンス

定義

名前空間:: System.Web.Security

アセンブリ:: System.Web.dll

アセンブリ:: System.Web.ApplicationServices.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

MembershipCreateUserException クラスの新しいインスタンスを初期化します。

オーバーロード

MembershipCreateUserException()	MembershipCreateUserException クラスの新しいインスタンスを初期化します。
MembershipCreateUserException(String)	MembershipCreateUserException クラスの新しいインスタンスを初期化し、指定された `message` パラメーター値に Message プロパティを設定します。
MembershipCreateUserException(MembershipCreateStatus)	指定した StatusCode 値を使用して、MembershipCreateUserException クラスの新しいインスタンスを初期化します。
MembershipCreateUserException(SerializationInfo, StreamingContext)	指定されたシリアル化情報とコンテキストを使用して、MembershipCreateUserException クラスの新しいインスタンスを初期化します。
MembershipCreateUserException(String, Exception)	MembershipCreateUserException クラスの新しいインスタンスを初期化して、Message プロパティを指定された `message` に設定し、InnerException プロパティを指定された `innerException` に設定します。

MembershipCreateUserException()

MembershipCreateUserException クラスの新しいインスタンスを初期化します。

public:
 MembershipCreateUserException();

public MembershipCreateUserException ();

Public Sub New ()

例

次のコード例では、メソッドを Membership.CreateUser 呼び出して新しいメンバーシップユーザーを作成します。ユーザーの作成が失敗すると、 MembershipCreateUserException がスローされます。

public MembershipUser MyCreateUser(string username, string password, string email,
                                   string question, string answer)
{
  MembershipCreateStatus status;

  MembershipUser u = Membership.CreateUser(username, password, email, question, 
                                           answer, true, out status);
  if (u == null)
  {
    throw new MembershipCreateUserException();
  }

  return u;
}

Public Function MyCreateUser(username As String, password As String, email As String, _
                             question As String, answer As String) As MembershipUser

  Dim status As MembershipCreateStatus

  Dim u As MembershipUser = Membership.CreateUser(username, password, email, question, _
                                                  answer, True, status)
  If u Is Nothing Then
    Throw New MembershipCreateUserException()
  End If

  Return u
End Function

注釈

クラスの MembershipCreateUserException インスタンスは、ユーザーが作成されていない場合に Membership.CreateUser メソッドによってスローされます。

こちらもご覧ください

ASP.NET メンバーシップの概要

適用対象

MembershipCreateUserException(String)

MembershipCreateUserException クラスの新しいインスタンスを初期化し、指定された message パラメーター値に Message プロパティを設定します。

public:
 MembershipCreateUserException(System::String ^ message);

public MembershipCreateUserException (string message);

new System.Web.Security.MembershipCreateUserException : string -> System.Web.Security.MembershipCreateUserException

Public Sub New (message As String)

パラメーター

message: String

例外の理由の説明。

例

次のコード例では、メソッドを Membership.CreateUser 呼び出して新しいメンバーシップユーザーを作成します。ユーザーの作成が失敗した場合は、 MembershipCreateUserException メソッドによって返されたに StatusCode 基づくメッセージを含むが CreateUser スローされます。

public MembershipUser MyCreateUser(string username, string password, string email,
                                   string question, string answer)
{
  MembershipCreateStatus status;

  MembershipUser u = Membership.CreateUser(username, password, email, question, 
                                           answer, true, out status);
  if (u == null)
  {
    throw new MembershipCreateUserException(GetErrorMessage(status));
  }

  return u;
}

public string GetErrorMessage(MembershipCreateStatus status)
{
   switch (status)
   {
      case MembershipCreateStatus.DuplicateUserName:
        return "Username already exists. Please enter a different user name.";

      case MembershipCreateStatus.DuplicateEmail:
        return "A username for that email address already exists. Please enter a different email address.";

      case MembershipCreateStatus.InvalidPassword:
        return "The password provided is invalid. Please enter a valid password value.";

      case MembershipCreateStatus.InvalidEmail:
        return "The email address provided is invalid. Please check the value and try again.";

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

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

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

      case MembershipCreateStatus.ProviderError:
        return "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:
        return "The user creation request has been canceled. Please verify your entry and try again. If the problem persists, please contact your system administrator.";

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

Public Function MyCreateUser(username As String, password As String, email As String, _
                             question As String, answer As String) As MembershipUser

  Dim status As MembershipCreateStatus

  Dim u As MembershipUser = Membership.CreateUser(username, password, email, question, _
                                                  answer, True, status)
  If u Is Nothing Then
    Throw New MembershipCreateUserException(GetErrorMessage(status))
  End If

  Return u
End Function


Public Function GetErrorMessage(status As MembershipCreateStatus) As String

   Select Case status
      Case MembershipCreateStatus.DuplicateUserName
        Return "Username already exists. Please enter a different user name."

      Case MembershipCreateStatus.DuplicateEmail
        Return "A username for that email address already exists. Please enter a different email address."

      Case MembershipCreateStatus.InvalidPassword
        Return "The password provided is invalid. Please enter a valid password value."

      Case MembershipCreateStatus.InvalidEmail
        Return "The email address provided is invalid. Please check the value and try again."

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

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

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

      Case MembershipCreateStatus.ProviderError
        Return "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
        Return "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
        Return "An unknown error occurred. Please verify your entry and try again. If the problem persists, please contact your system administrator."
   End Select
End Function

注釈

ユーザーが MembershipCreateUserException 作成されていない場合、 Membership.CreateUser クラスはメソッドによってスローされます。

パラメーターを message 使用すると、例外のプロパティを Message 例外の理由についてわかりやすい説明に設定できます。

こちらもご覧ください

ASP.NET メンバーシップの概要

適用対象

MembershipCreateUserException(MembershipCreateStatus)

指定した StatusCode 値を使用して、MembershipCreateUserException クラスの新しいインスタンスを初期化します。

public:
 MembershipCreateUserException(System::Web::Security::MembershipCreateStatus statusCode);

public MembershipCreateUserException (System.Web.Security.MembershipCreateStatus statusCode);

new System.Web.Security.MembershipCreateUserException : System.Web.Security.MembershipCreateStatus -> System.Web.Security.MembershipCreateUserException

Public Sub New (statusCode As MembershipCreateStatus)

パラメーター

statusCode: MembershipCreateStatus

例外の理由を示す MembershipCreateStatus 列挙値。

例

次のコード例では、メソッドを CreateUser 呼び出して新しいメンバーシップユーザーを作成します。ユーザーの作成が失敗した場合は、 MembershipCreateUserException メソッドによって返されるを StatusCode 使用してが CreateUser スローされます。

public MembershipUser MyCreateUser(string username, string password, string email,
                                   string question, string answer)
{
  MembershipCreateStatus status;

  MembershipUser u = Membership.CreateUser(username, password, email, question, 
                                           answer, true, out status);

  if (u == null)
  {
    throw new MembershipCreateUserException(status);
  }

  return u;
}

Public Function MyCreateUser(username As String, password As String, email As String, _
                             question As String, answer As String) As MembershipUser

  Dim status As MembershipCreateStatus

  Dim u As MembershipUser = Membership.CreateUser(username, password, email, question, _
                                                  answer, True, status)
  If u Is Nothing Then
    Throw New MembershipCreateUserException(status)
  End If

  Return u
End Function

注釈

ユーザーが MembershipCreateUserException 作成されていない場合、 Membership.CreateUser クラスはメソッドによってスローされます。

statusCodeパラメーターを使用すると、がスローされた理由をMembershipCreateUserException示すことができます。 statusCodeパラメーター値は、プロパティによってStatusCode公開されます。

こちらもご覧ください

ASP.NET メンバーシップの概要

適用対象

MembershipCreateUserException(SerializationInfo, StreamingContext)

指定されたシリアル化情報とコンテキストを使用して、MembershipCreateUserException クラスの新しいインスタンスを初期化します。

protected:
 MembershipCreateUserException(System::Runtime::Serialization::SerializationInfo ^ info, System::Runtime::Serialization::StreamingContext context);

protected MembershipCreateUserException (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);

new System.Web.Security.MembershipCreateUserException : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> System.Web.Security.MembershipCreateUserException

Protected Sub New (info As SerializationInfo, context As StreamingContext)

パラメーター

info: SerializationInfo

スローされている例外に関するシリアル化済みオブジェクトデータを保持している SerializationInfo。

context: StreamingContext

転送元または転送先についてのコンテキスト情報を含む StreamingContext です。

例

次の MembershipCreateUserException コード例は、指定されたシリアル化情報とコンテキストを使用して基底クラスの保護されたコンストラクターを呼び出すクラスの実装を示しています。

using System.Web.Security;
using System.Runtime.Serialization;

public sealed class MyCreateUserException : MembershipCreateUserException
{
  public MyCreateUserException(SerializationInfo info, StreamingContext context) : base(info, context)
  {
  }
}

Imports System.Web.Security
Imports System.Runtime.Serialization

Public NotInheritable Class MyCreateUserException
  Inherits MembershipCreateUserException

  Public Sub New (info As SerializationInfo, context As StreamingContext)
    MyBase.New(info, context)
  End Sub
End Class

注釈

このコンストラクターは、シリアル化解除の際に呼び出されて、ストリームで送信された例外オブジェクトを再構成します。詳細については、「 XML および SOAP のシリアル化」を参照してください。

こちらもご覧ください

ASP.NET メンバーシップの概要

適用対象

MembershipCreateUserException(String, Exception)

MembershipCreateUserException クラスの新しいインスタンスを初期化して、Message プロパティを指定された message に設定し、InnerException プロパティを指定された innerException に設定します。

public:
 MembershipCreateUserException(System::String ^ message, Exception ^ innerException);

public MembershipCreateUserException (string message, Exception innerException);

new System.Web.Security.MembershipCreateUserException : string * Exception -> System.Web.Security.MembershipCreateUserException

Public Sub New (message As String, innerException As Exception)

パラメーター

message: String

例外の理由の説明。

innerException: Exception

MembershipCreateUserException の原因となった例外。

例

次のコード例では、メソッドを CreateUser 呼び出して新しいメンバーシップユーザーを作成します。ユーザーの作成が失敗すると、 MembershipCreateUserException がスローされます。例外がでないMembershipCreateUserException場合、キャッチされた例外はスローされるの MembershipCreateUserException としてInnerException提供されます。

public MembershipUser MyCreateUser(string username, string password, string email)
{
  MembershipUser u = null;

  try
  {
    u = Membership.CreateUser(username, password, email);
  }
  catch (MembershipCreateUserException e)
  {  
    throw e;
  }
  catch (Exception e)
  {  
    throw new MembershipCreateUserException("An exception occurred creating the user.", e);
  }

  return u;
}

Public Function MyCreateUser(username As String, password As String, email As String) As MembershipUser

  Dim u As MembershipUser = Nothing

  Try
    u = Membership.CreateUser(username, password, email)
  Catch e As MembershipCreateUserException
    Throw e
  Catch e As Exception  
    Throw New MembershipCreateUserException("An exception occurred creating the user.", e)
  End Try

  Return u
End Function

注釈

クラスの MembershipCreateUserException インスタンスは、ユーザーが作成されていない場合に Membership.CreateUser メソッドによってスローされます。

コンストラクターのこのオーバーロードを使用して、 MembershipCreateUserException ユーザーの作成中に発生したキャッチされた例外に関する情報を提供できます。

こちらもご覧ください

ASP.NET メンバーシップの概要

適用対象

次の方法で共有

MembershipCreateUserException コンストラクター

定義

オーバーロード

MembershipCreateUserException()

例

注釈

こちらもご覧ください

適用対象

MembershipCreateUserException(String)

パラメーター

例

注釈

こちらもご覧ください

適用対象

MembershipCreateUserException(MembershipCreateStatus)

パラメーター

例

注釈

こちらもご覧ください

適用対象

MembershipCreateUserException(SerializationInfo, StreamingContext)

パラメーター

例

注釈

こちらもご覧ください

適用対象

MembershipCreateUserException(String, Exception)

パラメーター

例

注釈

こちらもご覧ください

適用対象

その他のリソース