MembershipCreateUserException Konstruktory

Definice

Obor názvů:

System.Web.Security

Sestavení:

System.Web.ApplicationServices.dll

Inicializuje novou instanci MembershipCreateUserException třídy .

Přetížení

MembershipCreateUserException()	Inicializuje novou instanci MembershipCreateUserException třídy .
MembershipCreateUserException(String)	Inicializuje novou instanci MembershipCreateUserException třídy a nastaví Message vlastnost na zadanou message hodnotu parametru.
MembershipCreateUserException(MembershipCreateStatus)	Inicializuje novou instanci MembershipCreateUserException třídy se zadanou StatusCode hodnotou.
MembershipCreateUserException(SerializationInfo, StreamingContext)	Inicializuje novou instanci MembershipCreateUserException třídy s zadanými serializačními informacemi a kontextem.
MembershipCreateUserException(String, Exception)	Inicializuje novou instanci MembershipCreateUserException třídy a nastaví Message vlastnost na zadanou message a InnerException vlastnost na zadanou innerException.

MembershipCreateUserException()

Inicializuje novou instanci MembershipCreateUserException třídy .

public:
 MembershipCreateUserException();

public MembershipCreateUserException ();

Public Sub New ()

Příklady

Následující příklad kódu volá metodu Membership.CreateUser k vytvoření nového člena uživatele. Pokud se vytvoření uživatele nezdaří, vyvolá se 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

Poznámky

Instance MembershipCreateUserException třídy je vyvolán metodou Membership.CreateUser , když uživatel není vytvořen.

Viz také

• Úvod do ASP.NET členství

MembershipCreateUserException(String)

Inicializuje novou instanci MembershipCreateUserException třídy a nastaví Message vlastnost na zadanou message hodnotu parametru.

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)

Parametry

message

String

Popis důvodu výjimky.

Příklady

Následující příklad kódu volá metodu Membership.CreateUser k vytvoření nového člena uživatele. Pokud se vytvoření uživatele nezdaří, MembershipCreateUserException vyvolá se zpráva na StatusCode základě vrácená metodou CreateUser .

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

Poznámky

Třída MembershipCreateUserException je vyvolán metodou Membership.CreateUser , když uživatel není vytvořen.

Pomocí parametru message můžete nastavit Message vlastnost výjimky na smysluplný popis důvodu výjimky.

Viz také

• Úvod do ASP.NET členství

MembershipCreateUserException(MembershipCreateStatus)

Inicializuje novou instanci MembershipCreateUserException třídy se zadanou StatusCode hodnotou.

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)

Parametry

statusCode

MembershipCreateStatus

Hodnota MembershipCreateStatus výčtu, která popisuje důvod výjimky.

Příklady

Následující příklad kódu volá metodu CreateUser k vytvoření nového člena uživatele. Pokud se vytvoření uživatele nezdaří, MembershipCreateUserException vyvolá se s objektem StatusCode vráceným metodou CreateUser .

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

Poznámky

Třída MembershipCreateUserException je vyvolán metodou Membership.CreateUser , když uživatel není vytvořen.

Parametr statusCode umožňuje určit, proč MembershipCreateUserException byl objekt vyvolán. Hodnota statusCode parametru StatusCode je zpřístupněna vlastností .

Viz také

• Úvod do ASP.NET členství

MembershipCreateUserException(SerializationInfo, StreamingContext)

Inicializuje novou instanci MembershipCreateUserException třídy s zadanými serializačními informacemi a kontextem.

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)

Parametry

info

SerializationInfo

Objekt SerializationInfo, ve kterém jsou uložena serializovaná data objektu týkající se výjimky

context

StreamingContext

Objekt StreamingContext obsahující kontextové informace o zdroji nebo cíli

Příklady

Následující příklad kódu ukazuje implementaci MembershipCreateUserException třídy, která volá chráněný konstruktor základní třídy se zadanými serializačními informacemi a kontextem.

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

Poznámky

Tento konstruktor je volán během deserializaci k rekonstrukci objektu výjimky přenášeného prostřednictvím toku. Další informace naleznete v tématu Serializace XML a SOAP.

Viz také

• Úvod do ASP.NET členství

MembershipCreateUserException(String, Exception)

Inicializuje novou instanci MembershipCreateUserException třídy a nastaví Message vlastnost na zadanou message a InnerException vlastnost na zadanou 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)

Parametry

message

String

Popis důvodu výjimky.

innerException

Exception

Výjimka, která způsobila MembershipCreateUserException.

Příklady

Následující příklad kódu volá metodu CreateUser k vytvoření nového člena uživatele. Pokud se vytvoření uživatele nezdaří, vyvolá se MembershipCreateUserException . Pokud výjimka není , zachycená MembershipCreateUserExceptionvýjimka je zadána jako InnerException vyvolána MembershipCreateUserException .

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

Poznámky

Instance MembershipCreateUserException třídy je vyvolán metodou Membership.CreateUser , když uživatel není vytvořen.

Toto přetížení konstruktoru MembershipCreateUserException můžete použít k zadání informací o zachycené výjimce, ke které došlo při vytváření uživatele.

Viz také

• Úvod do ASP.NET členství