MembershipCreateUserException Constructeurs

Définition

Espace de noms:

System.Web.Security

Assembly:

System.Web.ApplicationServices.dll

Initialise une nouvelle instance de la classe MembershipCreateUserException.

Surcharges

MembershipCreateUserException()	Initialise une nouvelle instance de la classe MembershipCreateUserException.
MembershipCreateUserException(String)	Initialise une nouvelle instance de la classe MembershipCreateUserException et affecte à la propriété Message la valeur de paramètre message fournie.
MembershipCreateUserException(MembershipCreateStatus)	Initialise une nouvelle instance de la classe MembershipCreateUserException avec la valeur StatusCode spécifiée.
MembershipCreateUserException(SerializationInfo, StreamingContext)	Initialise une nouvelle instance de la classe MembershipCreateUserException avec les informations de sérialisation et le contexte fournis.
MembershipCreateUserException(String, Exception)	Initialise une nouvelle instance de la classe MembershipCreateUserException et affecte à la propriété Message le message fourni et à la propriété InnerException le innerException fourni.

MembershipCreateUserException()

Initialise une nouvelle instance de la classe MembershipCreateUserException.

public:
 MembershipCreateUserException();

public MembershipCreateUserException ();

Public Sub New ()

Exemples

L’exemple de code suivant appelle la Membership.CreateUser méthode pour créer un utilisateur d’appartenance. Si la création de l’utilisateur échoue, un MembershipCreateUserException est levée.

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

Remarques

Une instance de la MembershipCreateUserException classe est levée par la Membership.CreateUser méthode lorsque l’utilisateur n’est pas créé.

Voir aussi

• Présentation de l’appartenance à ASP.NET

MembershipCreateUserException(String)

Initialise une nouvelle instance de la classe MembershipCreateUserException et affecte à la propriété Message la valeur de paramètre message fournie.

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)

Paramètres

message

String

Description de la cause de l’exception.

Exemples

L’exemple de code suivant appelle la Membership.CreateUser méthode pour créer un utilisateur d’appartenance. Si la création de l’utilisateur échoue, un MembershipCreateUserException est levée avec un message basé sur le StatusCode retourné par la CreateUser méthode.

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

Remarques

La MembershipCreateUserException classe est levée par la Membership.CreateUser méthode lorsque l’utilisateur n’est pas créé.

Vous pouvez utiliser le message paramètre pour définir la Message propriété de l’exception sur une description explicite de la raison de l’exception.

Voir aussi

• Présentation de l’appartenance à ASP.NET

MembershipCreateUserException(MembershipCreateStatus)

Initialise une nouvelle instance de la classe MembershipCreateUserException avec la valeur StatusCode spécifiée.

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)

Paramètres

statusCode

MembershipCreateStatus

Valeur d’énumération MembershipCreateStatus qui décrit la cause de l’exception.

Exemples

L’exemple de code suivant appelle la CreateUser méthode pour créer un utilisateur d’appartenance. Si la création de l’utilisateur échoue, un MembershipCreateUserException est levée avec le StatusCode retourné par la CreateUser méthode .

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

Remarques

La MembershipCreateUserException classe est levée par la Membership.CreateUser méthode lorsque l’utilisateur n’est pas créé.

Le statusCode paramètre vous permet d’indiquer la raison pour laquelle le MembershipCreateUserException a été levée. La statusCode valeur du paramètre est exposée par la StatusCode propriété .

Voir aussi

• Présentation de l’appartenance à ASP.NET

MembershipCreateUserException(SerializationInfo, StreamingContext)

Initialise une nouvelle instance de la classe MembershipCreateUserException avec les informations de sérialisation et le contexte fournis.

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)

Paramètres

info

SerializationInfo

SerializationInfo qui contient les données d'objet sérialisées concernant l'exception levée.

context

StreamingContext

StreamingContext qui contient des informations contextuelles relatives à la source ou à la destination.

Exemples

L’exemple de code suivant montre une implémentation de la MembershipCreateUserException classe qui appelle le constructeur protégé de la classe de base avec les informations de sérialisation et le contexte fournis.

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

Remarques

Ce constructeur est appelé lors de la désérialisation afin de reconstituer l'objet exception transmis sur un flux. Pour plus d’informations, consultez Sérialisation XML et SOAP.

Voir aussi

• Présentation de l’appartenance à ASP.NET

MembershipCreateUserException(String, Exception)

Initialise une nouvelle instance de la classe MembershipCreateUserException et affecte à la propriété Message le message fourni et à la propriété InnerException le innerException fourni.

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)

Paramètres

message

String

Description de la cause de l’exception.

innerException

Exception

Exception ayant provoqué le MembershipCreateUserException.

Exemples

L’exemple de code suivant appelle la CreateUser méthode pour créer un utilisateur d’appartenance. Si la création de l’utilisateur échoue, un MembershipCreateUserException est levée. Si l’exception n’est pas une MembershipCreateUserException, l’exception interceptée est fournie en tant InnerException que du MembershipCreateUserException qui est levée.

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

Remarques

Une instance de la MembershipCreateUserException classe est levée par la Membership.CreateUser méthode lorsque l’utilisateur n’est pas créé.

Vous pouvez utiliser cette surcharge du MembershipCreateUserException constructeur pour fournir des informations concernant une exception interceptée qui s’est produite pendant la création de l’utilisateur.

Voir aussi

• Présentation de l’appartenance à ASP.NET