MembershipCreateUserException Construtores

Definição

Namespace:

System.Web.Security

Assembly:

System.Web.ApplicationServices.dll

Inicializa uma nova instância da classe MembershipCreateUserException.

Sobrecargas

MembershipCreateUserException()	Inicializa uma nova instância da classe MembershipCreateUserException.
MembershipCreateUserException(String)	Inicializa uma nova instância da classe MembershipCreateUserException e define a propriedade Message como o valor do parâmetro message fornecido.
MembershipCreateUserException(MembershipCreateStatus)	Inicializa uma nova instância da classe MembershipCreateUserException com o valor StatusCode especificado.
MembershipCreateUserException(SerializationInfo, StreamingContext)	Inicializa uma nova instância da classe MembershipCreateUserException com o contexto e as informações de serialização fornecidos.
MembershipCreateUserException(String, Exception)	Inicializa uma nova instância da classe MembershipCreateUserException e define a propriedade Message como o message fornecido e a propriedade InnerException como o innerException fornecido.

MembershipCreateUserException()

Inicializa uma nova instância da classe MembershipCreateUserException.

public:
 MembershipCreateUserException();

public MembershipCreateUserException ();

Public Sub New ()

Exemplos

O exemplo de código a seguir chama o Membership.CreateUser método para criar um novo usuário de associação. Se a criação do usuário falhar, um MembershipCreateUserException será gerado.

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

Comentários

Uma instância da MembershipCreateUserException classe é gerada pelo Membership.CreateUser método quando o usuário não é criado.

Confira também

• Introdução à associação ASP.NET

MembershipCreateUserException(String)

Inicializa uma nova instância da classe MembershipCreateUserException e define a propriedade Message como o valor do parâmetro message fornecido.

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)

Parâmetros

message

String

Uma descrição do motivo da exceção.

Exemplos

O exemplo de código a seguir chama o Membership.CreateUser método para criar um novo usuário de associação. Se a criação do usuário falhar, um MembershipCreateUserException será gerado com uma mensagem com base no StatusCode retornado pelo CreateUser método .

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

Comentários

A MembershipCreateUserException classe é gerada pelo Membership.CreateUser método quando o usuário não é criado.

Você pode usar o message parâmetro para definir a Message propriedade da exceção como uma descrição significativa do motivo da exceção.

Confira também

• Introdução à associação ASP.NET

MembershipCreateUserException(MembershipCreateStatus)

Inicializa uma nova instância da classe MembershipCreateUserException com o valor StatusCode especificado.

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)

Parâmetros

statusCode

MembershipCreateStatus

Um valor de enumeração de MembershipCreateStatus que descreve o motivo da exceção.

Exemplos

O exemplo de código a seguir chama o CreateUser método para criar um novo usuário de associação. Se a criação do usuário falhar, um MembershipCreateUserException será gerado com o StatusCode retornado pelo CreateUser método .

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

Comentários

A MembershipCreateUserException classe é gerada pelo Membership.CreateUser método quando o usuário não é criado.

O statusCode parâmetro permite que você indique por que o MembershipCreateUserException foi gerado. O valor do statusCode parâmetro é exposto pela StatusCode propriedade .

Confira também

• Introdução à associação ASP.NET

MembershipCreateUserException(SerializationInfo, StreamingContext)

Inicializa uma nova instância da classe MembershipCreateUserException com o contexto e as informações de serialização fornecidos.

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)

Parâmetros

info

SerializationInfo

O SerializationInfo que mantém os dados de objeto serializados sobre a exceção que está sendo lançada.

context

StreamingContext

O StreamingContext que contém informações contextuais sobre a fonte ou o destino.

Exemplos

O exemplo de código a MembershipCreateUserException seguir mostra uma implementação da classe que chama o construtor protegido da classe base com as informações de serialização e o contexto fornecidos.

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

Comentários

O construtor é chamado durante a desserialização para reconstituir o objeto de exceção transmitido em um fluxo. Para obter mais informações, consulte serialização XML e SOAP.

Confira também

• Introdução à associação ASP.NET

MembershipCreateUserException(String, Exception)

Inicializa uma nova instância da classe MembershipCreateUserException e define a propriedade Message como o message fornecido e a propriedade InnerException como o innerException fornecido.

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)

Parâmetros

message

String

Uma descrição do motivo da exceção.

innerException

Exception

A exceção que causou o MembershipCreateUserException.

Exemplos

O exemplo de código a seguir chama o CreateUser método para criar um novo usuário de associação. Se a criação do usuário falhar, um MembershipCreateUserException será gerado. Se a exceção não for um MembershipCreateUserException, a exceção capturada será fornecida como a InnerExceptionMembershipCreateUserException do que é gerado.

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

Comentários

Uma instância da MembershipCreateUserException classe é gerada pelo Membership.CreateUser método quando o usuário não é criado.

Você pode usar essa sobrecarga do MembershipCreateUserException construtor para fornecer informações sobre uma exceção capturada que ocorreu enquanto o usuário estava sendo criado.

Confira também

• Introdução à associação ASP.NET