Freigeben über


MembershipCreateUserException Konstruktoren

Definition

Initialisiert eine neue Instanz der MembershipCreateUserException-Klasse.

Überlädt

MembershipCreateUserException()

Initialisiert eine neue Instanz der MembershipCreateUserException-Klasse.

MembershipCreateUserException(String)

Initialisiert eine neue Instanz der MembershipCreateUserException-Klasse, wobei die Message-Eigenschaft auf den angegebenen message-Parameterwert festgelegt ist.

MembershipCreateUserException(MembershipCreateStatus)

Initialisiert eine neue Instanz der MembershipCreateUserException-Klasse mit dem angegebenen StatusCode-Wert.

MembershipCreateUserException(SerializationInfo, StreamingContext)

Initialisiert eine neue Instanz der MembershipCreateUserException-Klasse mit den angegebenen Serialisierungsinformationen und dem angegebenen Kontext.

MembershipCreateUserException(String, Exception)

Initialisiert eine neue Instanz der MembershipCreateUserException-Klasse und legt die Message-Eigenschaft auf die angegebene message und die InnerException-Eigenschaft auf die angegebene innerException fest.

MembershipCreateUserException()

Initialisiert eine neue Instanz der MembershipCreateUserException-Klasse.

public:
 MembershipCreateUserException();
public MembershipCreateUserException ();
Public Sub New ()

Beispiele

Im folgenden Codebeispiel wird die Membership.CreateUser -Methode aufgerufen, um einen neuen Mitgliedschaftsbenutzer zu erstellen. Wenn bei der Benutzererstellung ein Fehler auftritt, wird ein MembershipCreateUserException ausgelöst.

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

Hinweise

Eine Instanz der MembershipCreateUserException -Klasse wird von der Membership.CreateUser -Methode ausgelöst, wenn der Benutzer nicht erstellt wird.

Weitere Informationen

Gilt für:

MembershipCreateUserException(String)

Initialisiert eine neue Instanz der MembershipCreateUserException-Klasse, wobei die Message-Eigenschaft auf den angegebenen message-Parameterwert festgelegt ist.

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)

Parameter

message
String

Eine Beschreibung des Grunds der Ausnahme.

Beispiele

Im folgenden Codebeispiel wird die Membership.CreateUser -Methode aufgerufen, um einen neuen Mitgliedschaftsbenutzer zu erstellen. Wenn die Benutzererstellung fehlschlägt, wird eine MembershipCreateUserException mit einer Nachricht ausgelöst, die auf der StatusCode von der CreateUser -Methode zurückgegebenen nachricht basiert.

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

Hinweise

Die MembershipCreateUserException -Klasse wird von der Membership.CreateUser -Methode ausgelöst, wenn der Benutzer nicht erstellt wird.

Sie können den message -Parameter verwenden, um die Message Eigenschaft der Ausnahme auf eine aussagekräftige Beschreibung des Grunds für die Ausnahme festzulegen.

Weitere Informationen

Gilt für:

MembershipCreateUserException(MembershipCreateStatus)

Initialisiert eine neue Instanz der MembershipCreateUserException-Klasse mit dem angegebenen StatusCode-Wert.

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)

Parameter

statusCode
MembershipCreateStatus

Ein MembershipCreateStatus-Enumerationswert, der den Grund für die Ausnahme beschreibt.

Beispiele

Im folgenden Codebeispiel wird die CreateUser -Methode aufgerufen, um einen neuen Mitgliedschaftsbenutzer zu erstellen. Wenn bei der Benutzererstellung ein Fehler auftritt, wird ein MembershipCreateUserException mit dem ausgelöst, das StatusCode von der CreateUser -Methode zurückgegeben wird.

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

Hinweise

Die MembershipCreateUserException -Klasse wird von der Membership.CreateUser -Methode ausgelöst, wenn der Benutzer nicht erstellt wird.

Mit statusCode dem Parameter können Sie angeben, warum die MembershipCreateUserException ausgelöst wurde. Der statusCode Parameterwert wird von der StatusCode -Eigenschaft verfügbar gemacht.

Weitere Informationen

Gilt für:

MembershipCreateUserException(SerializationInfo, StreamingContext)

Initialisiert eine neue Instanz der MembershipCreateUserException-Klasse mit den angegebenen Serialisierungsinformationen und dem angegebenen Kontext.

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)

Parameter

info
SerializationInfo

Die SerializationInfo, die die serialisierten Objektdaten für die ausgelöste Ausnahme enthält.

context
StreamingContext

Der StreamingContext, der die Kontextinformationen über die Quelle oder das Ziel enthält.

Beispiele

Das folgende Codebeispiel zeigt eine Implementierung der -Klasse, die MembershipCreateUserException den geschützten Konstruktor der Basisklasse mit den angegebenen Serialisierungsinformationen und dem angegebenen Kontext aufruft.

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

Hinweise

Dieser Konstruktor wird während der Deserialisierung aufgerufen, um das über einen Datenstrom übertragene Ausnahmeobjekt wieder zusammenzusetzen. Weitere Informationen finden Sie unter XML- und SOAP-Serialisierung.

Weitere Informationen

Gilt für:

MembershipCreateUserException(String, Exception)

Initialisiert eine neue Instanz der MembershipCreateUserException-Klasse und legt die Message-Eigenschaft auf die angegebene message und die InnerException-Eigenschaft auf die angegebene innerException fest.

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)

Parameter

message
String

Eine Beschreibung des Grunds der Ausnahme.

innerException
Exception

Die Ausnahme, die die MembershipCreateUserException verursacht hat.

Beispiele

Im folgenden Codebeispiel wird die CreateUser -Methode aufgerufen, um einen neuen Mitgliedschaftsbenutzer zu erstellen. Wenn bei der Benutzererstellung ein Fehler auftritt, wird ein MembershipCreateUserException ausgelöst. Wenn die Ausnahme keine MembershipCreateUserExceptionist, wird die abgefangene Ausnahme als die InnerException der bereitgestellt, die MembershipCreateUserException ausgelöst wird.

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

Hinweise

Eine Instanz der MembershipCreateUserException -Klasse wird von der Membership.CreateUser -Methode ausgelöst, wenn der Benutzer nicht erstellt wird.

Sie können diese Überladung des MembershipCreateUserException Konstruktors verwenden, um Informationen zu einer abgefangenen Ausnahme anzugeben, die beim Erstellen des Benutzers aufgetreten ist.

Weitere Informationen

Gilt für: