MembershipCreateUserException コンストラクタ

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

MembershipCreateUserException コンストラクタ (String, Exception)

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

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

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

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim message As String
Dim innerException As Exception

Dim instance As New MembershipCreateUserException(message,
 innerException)

C#

public MembershipCreateUserException (
    string message,
    Exception innerException
)

C++

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

J#

public MembershipCreateUserException (
    String message, 
    Exception innerException
)

JScript

public function MembershipCreateUserException
 (
    message : String, 
    innerException : Exception
)

パラメータ

message

例外の理由に関する説明。

innerException

MembershipCreateUserException の原因になる例外。

解説

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

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

使用例

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

Visual Basic

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

C#

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;
}

プラットフォーム

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

参照

関連項目
MembershipCreateUserException クラス
MembershipCreateUserException メンバ
System.Web.Security 名前空間
その他の技術情報
メンバシップの概要

MembershipCreateUserException コンストラクタ (SerializationInfo, StreamingContext)

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

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

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

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim info As SerializationInfo
Dim context As StreamingContext

Dim instance As New MembershipCreateUserException(info,
 context)

C#

protected MembershipCreateUserException (
    SerializationInfo info,
    StreamingContext context
)

C++

protected:
MembershipCreateUserException (
    SerializationInfo^ info, 
    StreamingContext context
)

J#

protected MembershipCreateUserException (
    SerializationInfo info, 
    StreamingContext context
)

JScript

protected function MembershipCreateUserException
 (
    info : SerializationInfo, 
    context : StreamingContext
)

パラメータ

info

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

context

転送元または転送先に関するコンテキスト情報を含んでいる StreamingContext。

解説

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

使用例

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

Visual Basic

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

C#

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

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

プラットフォーム

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

参照

関連項目
MembershipCreateUserException クラス
MembershipCreateUserException メンバ
System.Web.Security 名前空間
その他の技術情報
メンバシップの概要

MembershipCreateUserException コンストラクタ (MembershipCreateStatus)

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

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

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

Visual Basic (宣言)

Public Sub New ( _
    statusCode As MembershipCreateStatus _
)

Visual Basic (使用法)

Dim statusCode As MembershipCreateStatus

Dim instance As New MembershipCreateUserException(statusCode)

C#

public MembershipCreateUserException (
    MembershipCreateStatus statusCode
)

C++

public:
MembershipCreateUserException (
    MembershipCreateStatus statusCode
)

J#

public MembershipCreateUserException (
    MembershipCreateStatus statusCode
)

JScript

public function MembershipCreateUserException
 (
    statusCode : MembershipCreateStatus
)

パラメータ

statusCode

例外の理由を説明する MembershipCreateStatus 列挙値。

解説

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

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

使用例

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

Visual Basic

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

C#

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;
}

プラットフォーム

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

参照

関連項目
MembershipCreateUserException クラス
MembershipCreateUserException メンバ
System.Web.Security 名前空間
その他の技術情報
メンバシップの概要

MembershipCreateUserException コンストラクタ

MembershipCreateUserException クラスの新しいインスタンスを初期化します。
オーバーロードの一覧

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

参照

関連項目

MembershipCreateUserException クラス
MembershipCreateUserException メンバ
System.Web.Security 名前空間

その他の技術情報

メンバシップの概要

MembershipCreateUserException コンストラクタ (String)

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

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

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

Visual Basic (宣言)

Public Sub New ( _
    message As String _
)

Visual Basic (使用法)

Dim message As String

Dim instance As New MembershipCreateUserException(message)

C#

public MembershipCreateUserException (
    string message
)

C++

public:
MembershipCreateUserException (
    String^ message
)

J#

public MembershipCreateUserException (
    String message
)

JScript

public function MembershipCreateUserException
 (
    message : String
)

パラメータ

message

例外の理由に関する説明。

解説

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

message パラメータを使用して、例外の Message プロパティに例外の理由に関する適切な説明を設定します。

使用例

Membership.CreateUser メソッドを呼び出して、新しいメンバシップ ユーザーを作成するコード例を次に示します。ユーザーの作成に失敗すると、CreateUser メソッドが返す StatusCode に基づくメッセージと共に MembershipCreateUserException がスローされます。

Visual Basic

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 e-mail
 address already exists. Please enter a different e-mail address."

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

      Case MembershipCreateStatus.InvalidEmail
        Return "The e-mail 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

C#

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 e-mail
 address already exists. Please enter a different e-mail address.";

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

      case MembershipCreateStatus.InvalidEmail:
        return "The e-mail 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.";
   }
}

プラットフォーム

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

参照

関連項目
MembershipCreateUserException クラス
MembershipCreateUserException メンバ
System.Web.Security 名前空間
その他の技術情報
メンバシップの概要

MembershipCreateUserException コンストラクタ ()

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

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

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

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New MembershipCreateUserException

C#

public MembershipCreateUserException ()

C++

public:
MembershipCreateUserException ()

J#

public MembershipCreateUserException ()

JScript

public function MembershipCreateUserException
 ()

解説

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

使用例

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

Visual Basic

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

C#

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;
}

プラットフォーム

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

参照

関連項目
MembershipCreateUserException クラス
MembershipCreateUserException メンバ
System.Web.Security 名前空間
その他の技術情報
メンバシップの概要