MembershipCreateUserException 생성자

참조

정의

네임스페이스:: System.Web.Security

어셈블리:: System.Web.dll

어셈블리:: System.Web.ApplicationServices.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

MembershipCreateUserException 클래스의 새 인스턴스를 초기화합니다.

오버로드

MembershipCreateUserException()	MembershipCreateUserException 클래스의 새 인스턴스를 초기화합니다.
MembershipCreateUserException(String)	MembershipCreateUserException 클래스의 새 인스턴스를 초기화하고 Message 속성을 제공된 `message` 매개 변수 값으로 설정합니다.
MembershipCreateUserException(MembershipCreateStatus)	지정된 MembershipCreateUserException 값을 사용하여 StatusCode 클래스의 새 인스턴스를 초기화합니다.
MembershipCreateUserException(SerializationInfo, StreamingContext)	제공된 serialization 정보와 컨텍스트를 사용하여 MembershipCreateUserException 클래스의 새 인스턴스를 초기화합니다.
MembershipCreateUserException(String, Exception)	MembershipCreateUserException 클래스의 새 인스턴스를 초기화하며 Message 속성을 제공된 `message`로 설정하고 InnerException 속성을 제공된 `innerException`으로 설정합니다.

MembershipCreateUserException()

MembershipCreateUserException 클래스의 새 인스턴스를 초기화합니다.

public:
 MembershipCreateUserException();

public MembershipCreateUserException ();

Public Sub New ()

예제

다음 코드 예제에서는 메서드를 Membership.CreateUser 호출하여 새 멤버 자격 사용자를 만듭니다. 사용자 만들기에 실패하면 throw 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 의해 throw됩니다.

추가 정보

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 하면 메서드에서 반환 CreateUser 된 메시지를 사용하여 StatusCode throw됩니다.

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 throw됩니다.

매개 변수를 message 사용하여 예외의 속성을 예외 이유에 대한 의미 있는 설명으로 설정할 Message 수 있습니다.

추가 정보

ASP.NET 멤버 자격 소개

적용 대상

MembershipCreateUserException(MembershipCreateStatus)

지정된 MembershipCreateUserException 값을 사용하여 StatusCode 클래스의 새 인스턴스를 초기화합니다.

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 하면 메서드가 반환 CreateUser 한 StatusCode 값과 함께 throw됩니다.

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 throw됩니다.

매개 statusCode 변수를 사용하면 throw된 이유를 MembershipCreateUserException 나타낼 수 있습니다. statusCode 매개 변수 값은 속성에 StatusCode 의해 노출됩니다.

추가 정보

ASP.NET 멤버 자격 소개

적용 대상

MembershipCreateUserException(SerializationInfo, StreamingContext)

제공된 serialization 정보와 컨텍스트를 사용하여 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

throw되는 예외에 대해 serialize된 개체 데이터를 보유하는 SerializationInfo입니다.

context: StreamingContext

소스 또는 대상에 대한 컨텍스트 정보를 포함하는 StreamingContext입니다.

예제

다음 코드 예제에서는 제공된 serialization 정보 및 컨텍스트를 사용하여 기본 클래스의 보호된 생성자를 호출하는 클래스의 구현 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 Serialization합니다.

추가 정보

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 호출하여 새 멤버 자격 사용자를 만듭니다. 사용자 만들기에 실패하면 throw MembershipCreateUserException 됩니다. 예외가 아닌 MembershipCreateUserException경우 catch된 예외는 throw된 예외로 InnerException MembershipCreateUserException 제공됩니다.

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 의해 throw됩니다.

생성자의 이 오버로드를 MembershipCreateUserException 사용하여 사용자가 생성되는 동안 발생한 catch된 예외에 대한 정보를 제공할 수 있습니다.

추가 정보

ASP.NET 멤버 자격 소개

적용 대상

MembershipCreateUserException 생성자

정의

오버로드

MembershipCreateUserException()

예제

설명

추가 정보

적용 대상

MembershipCreateUserException(String)

매개 변수

예제

설명

추가 정보

적용 대상

MembershipCreateUserException(MembershipCreateStatus)

매개 변수

예제

설명

추가 정보

적용 대상

MembershipCreateUserException(SerializationInfo, StreamingContext)

매개 변수

예제

설명

추가 정보

적용 대상

MembershipCreateUserException(String, Exception)

매개 변수

예제

설명

추가 정보

적용 대상

추가 리소스