MembershipCreateUserException Konstruktory

Definicja

Przestrzeń nazw:

System.Web.Security

Zestaw:

System.Web.ApplicationServices.dll

Inicjuje nowe wystąpienie klasy MembershipCreateUserException.

Przeciążenia

MembershipCreateUserException()	Inicjuje nowe wystąpienie klasy MembershipCreateUserException.
MembershipCreateUserException(String)	Inicjuje MembershipCreateUserException nowe wystąpienie klasy i ustawia Message właściwość na wartość podanego message parametru.
MembershipCreateUserException(MembershipCreateStatus)	Inicjuje MembershipCreateUserException nowe wystąpienie klasy o określonej StatusCode wartości.
MembershipCreateUserException(SerializationInfo, StreamingContext)	Inicjuje MembershipCreateUserException nowe wystąpienie klasy z podanymi informacjami serializacji i kontekstem.
MembershipCreateUserException(String, Exception)	Inicjuje MembershipCreateUserException nowe wystąpienie klasy i ustawia Message właściwość na dostarczoną message i InnerException właściwość na podany innerExceptionelement .

MembershipCreateUserException()

Inicjuje nowe wystąpienie klasy MembershipCreateUserException.

public:
 MembershipCreateUserException();

public MembershipCreateUserException ();

Public Sub New ()

Przykłady

Poniższy przykład kodu wywołuje metodę Membership.CreateUser , aby utworzyć nowego użytkownika członkostwa. Jeśli tworzenie użytkownika zakończy się niepowodzeniem MembershipCreateUserException , zostanie zgłoszony błąd.

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

Uwagi

Wystąpienie MembershipCreateUserException klasy jest zgłaszane przez metodę Membership.CreateUser , gdy użytkownik nie zostanie utworzony.

Zobacz też

• Wprowadzenie do członkostwa w ASP.NET

MembershipCreateUserException(String)

Inicjuje MembershipCreateUserException nowe wystąpienie klasy i ustawia Message właściwość na wartość podanego message 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

Opis przyczyny wyjątku.

Przykłady

Poniższy przykład kodu wywołuje metodę Membership.CreateUser , aby utworzyć nowego użytkownika członkostwa. Jeśli tworzenie użytkownika zakończy się niepowodzeniem, MembershipCreateUserException zostanie zgłoszony komunikat na podstawie StatusCode zwracanej przez metodę 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

Uwagi

Klasa MembershipCreateUserException jest zgłaszana przez metodę Membership.CreateUser , gdy użytkownik nie zostanie utworzony.

Możesz użyć parametru message , aby ustawić Message właściwość wyjątku na zrozumiały opis przyczyny wyjątku.

Zobacz też

• Wprowadzenie do członkostwa w ASP.NET

MembershipCreateUserException(MembershipCreateStatus)

Inicjuje MembershipCreateUserException nowe wystąpienie klasy o określonej StatusCode wartości.

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

MembershipCreateStatus Wartość wyliczenia, która opisuje przyczynę wyjątku.

Przykłady

Poniższy przykład kodu wywołuje metodę CreateUser , aby utworzyć nowego użytkownika członkostwa. Jeśli tworzenie użytkownika zakończy się niepowodzeniem, MembershipCreateUserException zostanie zwrócony StatusCode przez metodę 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

Uwagi

Klasa MembershipCreateUserException jest zgłaszana przez metodę Membership.CreateUser , gdy użytkownik nie zostanie utworzony.

Parametr statusCode umożliwia wskazanie, dlaczego MembershipCreateUserException został zgłoszony. Wartość statusCode parametru StatusCode jest uwidoczniona przez właściwość .

Zobacz też

• Wprowadzenie do członkostwa w ASP.NET

MembershipCreateUserException(SerializationInfo, StreamingContext)

Inicjuje MembershipCreateUserException nowe wystąpienie klasy z podanymi informacjami serializacji i kontekstem.

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

Obiekt SerializationInfo zawierający dane zserializowanego obiektu dotyczące zgłaszanego wyjątku.

context

StreamingContext

Obiekt StreamingContext zawierający informacje kontekstowe dotyczące źródła lub miejsca docelowego.

Przykłady

Poniższy przykład kodu przedstawia implementację MembershipCreateUserException klasy, która wywołuje chroniony konstruktor klasy bazowej z podanymi informacjami serializacji i kontekstem.

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

Uwagi

Ten konstruktor jest wywoływana podczas deserializacji do odtworzenia obiektu wyjątku przesyłanego za pomocą strumienia. Aby uzyskać więcej informacji, zobacz Serializacja XML i SOAP.

Zobacz też

• Wprowadzenie do członkostwa w ASP.NET

MembershipCreateUserException(String, Exception)

Inicjuje MembershipCreateUserException nowe wystąpienie klasy i ustawia Message właściwość na dostarczoną message i InnerException właściwość na podany innerExceptionelement .

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

Opis przyczyny wyjątku.

innerException

Exception

Wyjątek, który spowodował MembershipCreateUserException.

Przykłady

Poniższy przykład kodu wywołuje metodę CreateUser , aby utworzyć nowego użytkownika członkostwa. Jeśli tworzenie użytkownika zakończy się niepowodzeniem MembershipCreateUserException , zostanie zgłoszony błąd. Jeśli wyjątek nie MembershipCreateUserExceptionjest , przechwycony wyjątek jest dostarczany jako InnerExceptionMembershipCreateUserException zgłaszany.

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

Uwagi

Wystąpienie MembershipCreateUserException klasy jest zgłaszane przez metodę Membership.CreateUser , gdy użytkownik nie zostanie utworzony.

Za pomocą tego przeciążenia konstruktora MembershipCreateUserException można podać informacje dotyczące przechwyconego wyjątku, który wystąpił podczas tworzenia użytkownika.

Zobacz też

• Wprowadzenie do członkostwa w ASP.NET