MembershipCreateUserException Constructores

Definición

Espacio de nombres:

System.Web.Security

Ensamblado:

System.Web.ApplicationServices.dll

Inicializa una nueva instancia de la clase MembershipCreateUserException.

Sobrecargas

MembershipCreateUserException()	Inicializa una nueva instancia de la clase MembershipCreateUserException.
MembershipCreateUserException(String)	Inicializa una nueva instancia de la clase MembershipCreateUserException y establece la propiedad Message en el valor del parámetro message proporcionado.
MembershipCreateUserException(MembershipCreateStatus)	Inicializa una nueva instancia de la clase MembershipCreateUserException con el valor StatusCode especificado.
MembershipCreateUserException(SerializationInfo, StreamingContext)	Inicializa una nueva instancia de la clase MembershipCreateUserException con la información y el contexto de serialización suministrados.
MembershipCreateUserException(String, Exception)	Inicializa una nueva instancia de la clase MembershipCreateUserException y establece la propiedad Message para el message proporcionado y la propiedad InnerException para la innerException proporcionada.

MembershipCreateUserException()

Inicializa una nueva instancia de la clase MembershipCreateUserException.

public:
 MembershipCreateUserException();

public MembershipCreateUserException ();

Public Sub New ()

Ejemplos

En el ejemplo de código siguiente se llama al Membership.CreateUser método para crear un nuevo usuario de pertenencia. Si se produce un error en la creación del usuario, se produce una MembershipCreateUserException excepción .

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

Comentarios

El método inicia Membership.CreateUser una instancia de la MembershipCreateUserException clase cuando no se crea el usuario.

Consulte también

• Introducción a la pertenencia a ASP.NET

MembershipCreateUserException(String)

Inicializa una nueva instancia de la clase MembershipCreateUserException y establece la propiedad Message en el valor del parámetro message proporcionado.

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

Descripción del motivo de la excepción.

Ejemplos

En el ejemplo de código siguiente se llama al Membership.CreateUser método para crear un nuevo usuario de pertenencia. Si se produce un error en la creación del usuario, se produce un MembershipCreateUserException mensaje basado en el StatusCode devuelto por el 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

Comentarios

El MembershipCreateUserException método inicia la Membership.CreateUser clase cuando no se crea el usuario.

Puede usar el message parámetro para establecer la Message propiedad de la excepción en una descripción significativa del motivo de la excepción.

Consulte también

• Introducción a la pertenencia a ASP.NET

MembershipCreateUserException(MembershipCreateStatus)

Inicializa una nueva instancia de la clase MembershipCreateUserException con el 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

Valor de enumeración MembershipCreateStatus que describe la razón de la excepción.

Ejemplos

En el ejemplo de código siguiente se llama al CreateUser método para crear un nuevo usuario de pertenencia. Si se produce un error en la creación del usuario, se produce una MembershipCreateUserException excepción con el StatusCode devuelto por el 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

Comentarios

El MembershipCreateUserException método inicia la Membership.CreateUser clase cuando no se crea el usuario.

El statusCode parámetro le permite indicar por qué se produjo .MembershipCreateUserException La propiedad expone el statusCode valor del StatusCode parámetro.

Consulte también

• Introducción a la pertenencia a ASP.NET

MembershipCreateUserException(SerializationInfo, StreamingContext)

Inicializa una nueva instancia de la clase MembershipCreateUserException con la información y el contexto de serialización suministrados.

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

SerializationInfo que contiene los datos serializados del objeto que hacen referencia a la excepción que se va a producir.

context

StreamingContext

StreamingContext que contiene información contextual sobre el origen o el destino.

Ejemplos

En el ejemplo de código siguiente se muestra una implementación de la MembershipCreateUserException clase que llama al constructor protegido de la clase base con la información y el contexto de serialización proporcionados.

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

Comentarios

Se llama a este constructor durante la deserialización para reconstituir el objeto de excepción transmitido en un flujo. Para obtener más información, consulte Serialización XML y SOAP.

Consulte también

• Introducción a la pertenencia a ASP.NET

MembershipCreateUserException(String, Exception)

Inicializa una nueva instancia de la clase MembershipCreateUserException y establece la propiedad Message para el message proporcionado y la propiedad InnerException para la innerException proporcionada.

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

Descripción del motivo de la excepción.

innerException

Exception

Excepción que provocó la MembershipCreateUserException.

Ejemplos

En el ejemplo de código siguiente se llama al CreateUser método para crear un nuevo usuario de pertenencia. Si se produce un error en la creación del usuario, se produce una MembershipCreateUserException excepción . Si la excepción no es , MembershipCreateUserExceptionla excepción detectada se proporciona como el InnerException de que MembershipCreateUserException se produce.

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

Comentarios

El método inicia Membership.CreateUser una instancia de la MembershipCreateUserException clase cuando no se crea el usuario.

Puede usar esta sobrecarga del MembershipCreateUserException constructor para proporcionar información sobre una excepción detectada que se produjo mientras se creaba el usuario.

Consulte también

• Introducción a la pertenencia a ASP.NET