MembershipCreateUserException Costruttori

Definizione

Spazio dei nomi:

System.Web.Security

Assembly:

System.Web.ApplicationServices.dll

Inizializza una nuova istanza della classe MembershipCreateUserException.

Overload

Nome	Descrizione
MembershipCreateUserException()	Inizializza una nuova istanza della classe MembershipCreateUserException.
MembershipCreateUserException(String)	Inizializza una nuova istanza della MembershipCreateUserException classe e imposta la Message proprietà sul valore del parametro fornito message .
MembershipCreateUserException(MembershipCreateStatus)	Inizializza una nuova istanza della MembershipCreateUserException classe con il valore specificato StatusCode .
MembershipCreateUserException(SerializationInfo, StreamingContext)	Inizializza una nuova istanza della MembershipCreateUserException classe con le informazioni e il contesto di serializzazione forniti.
MembershipCreateUserException(String, Exception)	Inizializza una nuova istanza della MembershipCreateUserException classe e imposta la Message proprietà sull'oggetto fornito message e la InnerException proprietà sull'oggetto fornito innerException.

MembershipCreateUserException()

Inizializza una nuova istanza della classe MembershipCreateUserException.

public:
 MembershipCreateUserException();

public MembershipCreateUserException();

Public Sub New ()

Esempio

Nell'esempio di codice seguente viene chiamato il Membership.CreateUser metodo per creare un nuovo utente di appartenenza. Se la creazione dell'utente non riesce, viene generata un'eccezione 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

Commenti

Un'istanza della MembershipCreateUserException classe viene generata dal Membership.CreateUser metodo quando l'utente non viene creato.

Vedi anche

• Introduzione all'appartenenza a ASP.NET

MembershipCreateUserException(String)

Inizializza una nuova istanza della MembershipCreateUserException classe e imposta la Message proprietà sul valore del parametro fornito 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)

Parametri

message

String

Descrizione del motivo dell'eccezione.

Esempio

Nell'esempio di codice seguente viene chiamato il Membership.CreateUser metodo per creare un nuovo utente di appartenenza. Se la creazione dell'utente ha esito negativo, viene generata un'eccezione MembershipCreateUserException con un messaggio basato sull'oggetto StatusCode restituito dal CreateUser metodo .

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

Commenti

La MembershipCreateUserException classe viene generata dal Membership.CreateUser metodo quando l'utente non viene creato.

È possibile utilizzare il message parametro per impostare la Message proprietà dell'eccezione su una descrizione significativa del motivo dell'eccezione.

Vedi anche

• Introduzione all'appartenenza a ASP.NET

MembershipCreateUserException(MembershipCreateStatus)

Inizializza una nuova istanza della MembershipCreateUserException classe con il valore specificato 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)

Parametri

statusCode

MembershipCreateStatus

Valore MembershipCreateStatus di enumerazione che descrive il motivo dell'eccezione.

Esempio

Nell'esempio di codice seguente viene chiamato il CreateUser metodo per creare un nuovo utente di appartenenza. Se la creazione dell'utente ha esito negativo, viene generata un'eccezione MembershipCreateUserException con l'oggetto StatusCode restituito dal CreateUser metodo .

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

Commenti

La MembershipCreateUserException classe viene generata dal Membership.CreateUser metodo quando l'utente non viene creato.

Il statusCode parametro consente di indicare il motivo per cui MembershipCreateUserException è stato generato . Il valore del statusCodeStatusCode parametro viene esposto dalla proprietà .

Vedi anche

• Introduzione all'appartenenza a ASP.NET

MembershipCreateUserException(SerializationInfo, StreamingContext)

Inizializza una nuova istanza della MembershipCreateUserException classe con le informazioni e il contesto di serializzazione forniti.

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)

Parametri

info

SerializationInfo

Il SerializationInfo che contiene i dati dell'oggetto serializzato relativi all'eccezione generata.

context

StreamingContext

Il StreamingContext che contiene informazioni contestuali sull'origine o sulla destinazione.

Esempio

Nell'esempio di codice seguente viene illustrata un'implementazione della MembershipCreateUserException classe che chiama il costruttore protetto della classe base con le informazioni e il contesto di serializzazione forniti.

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

Commenti

Questo costruttore viene chiamato durante la deserializzazione per ricostituire l'oggetto eccezione trasmesso su un flusso. Per altre informazioni, vedere Serializzazione XML e SOAP.

Vedi anche

• Introduzione all'appartenenza a ASP.NET

MembershipCreateUserException(String, Exception)

Inizializza una nuova istanza della MembershipCreateUserException classe e imposta la Message proprietà sull'oggetto fornito message e la InnerException proprietà sull'oggetto fornito 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)

Parametri

message

String

Descrizione del motivo dell'eccezione.

innerException

Exception

Eccezione che ha causato l'oggetto MembershipCreateUserException.

Esempio

Nell'esempio di codice seguente viene chiamato il CreateUser metodo per creare un nuovo utente di appartenenza. Se la creazione dell'utente non riesce, viene generata un'eccezione MembershipCreateUserException . Se l'eccezione non è un MembershipCreateUserException, l'eccezione intercettata viene fornita come InnerException dell'oggetto MembershipCreateUserException generato.

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

Commenti

Un'istanza della MembershipCreateUserException classe viene generata dal Membership.CreateUser metodo quando l'utente non viene creato.

È possibile utilizzare questo overload del MembershipCreateUserException costruttore per fornire informazioni relative a un'eccezione rilevata che si è verificata durante la creazione dell'utente.

Vedi anche

• Introduzione all'appartenenza a ASP.NET