MembershipCreateUserException Конструкторы

Определение

Пространство имен:

System.Web.Security

Сборка:

System.Web.ApplicationServices.dll

Инициализирует новый экземпляр класса MembershipCreateUserException.

Перегрузки

MembershipCreateUserException()	Инициализирует новый экземпляр класса MembershipCreateUserException.
MembershipCreateUserException(String)	Инициализирует новый экземпляр класса MembershipCreateUserException и присваивает свойству Message указанное значение параметра message.
MembershipCreateUserException(MembershipCreateStatus)	Инициализирует новый экземпляр класса MembershipCreateUserException заданным значением StatusCode.
MembershipCreateUserException(SerializationInfo, StreamingContext)	Инициализирует новый экземпляр класса MembershipCreateUserException с указанными сведениями о сериализации и контекстом.
MembershipCreateUserException(String, Exception)	Инициализирует новый экземпляр класса MembershipCreateUserException, а также задает в свойстве Message предоставленное message и в свойстве InnerException предоставленное innerException.

MembershipCreateUserException()

Инициализирует новый экземпляр класса MembershipCreateUserException.

public:
 MembershipCreateUserException();

public MembershipCreateUserException ();

Public Sub New ()

Примеры

В следующем примере кода вызывается Membership.CreateUser метод для создания нового пользователя членства. Если создание пользователя завершается сбоем 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

Комментарии

Экземпляр MembershipCreateUserException класса создается методом , Membership.CreateUser когда пользователь не создан.

См. также раздел

• Общие сведения о членстве в ASP.NET

MembershipCreateUserException(String)

Инициализирует новый экземпляр класса MembershipCreateUserException и присваивает свойству Message указанное значение параметра 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)

Параметры

message

String

Описание причины исключения.

Примеры

В следующем примере кода вызывается Membership.CreateUser метод для создания нового пользователя членства. Если создание пользователя завершается сбоем MembershipCreateUserException , возникает исключение с сообщением на StatusCode основе , возвращаемого методом 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

Комментарии

Класс MembershipCreateUserException создается методом , Membership.CreateUser когда пользователь не создан.

С помощью message параметра можно задать Message для свойства исключения понятное описание причины исключения.

См. также раздел

• Общие сведения о членстве в ASP.NET

MembershipCreateUserException(MembershipCreateStatus)

Инициализирует новый экземпляр класса MembershipCreateUserException заданным значением 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)

Параметры

statusCode

MembershipCreateStatus

Значение перечисления MembershipCreateStatus, которое описывает причину возникновения исключения.

Примеры

В следующем примере кода вызывается CreateUser метод для создания нового пользователя членства. Если создание пользователя завершается сбоем MembershipCreateUserException , возникает исключение с StatusCode возвращаемым методом 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

Комментарии

Класс MembershipCreateUserException создается методом , Membership.CreateUser когда пользователь не создан.

Параметр statusCode позволяет указать причину MembershipCreateUserException , по которой был создан объект . Значение statusCode параметра предоставляется свойством StatusCode .

См. также раздел

• Общие сведения о членстве в ASP.NET

MembershipCreateUserException(SerializationInfo, StreamingContext)

Инициализирует новый экземпляр класса MembershipCreateUserException с указанными сведениями о сериализации и контекстом.

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)

Параметры

info

SerializationInfo

Объект SerializationInfo, хранящий сериализованные данные объекта, относящиеся к выдаваемому исключению.

context

StreamingContext

Объект StreamingContext, содержащий контекстные сведения об источнике или назначении.

Примеры

В следующем примере кода показана MembershipCreateUserException реализация класса , который вызывает защищенный конструктор базового класса с предоставленными сведениями о сериализации и контекстом.

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

Комментарии

Этот конструктор вызывается во время десериализации для восстановления объекта исключения, переданного в потоке. Дополнительные сведения см. в разделе Сериализация XML и SOAP.

См. также раздел

• Общие сведения о членстве в ASP.NET

MembershipCreateUserException(String, Exception)

Инициализирует новый экземпляр класса MembershipCreateUserException, а также задает в свойстве Message предоставленное message и в свойстве InnerException предоставленное 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)

Параметры

message

String

Описание причины исключения.

innerException

Exception

Исключение, вызвавшее MembershipCreateUserException.

Примеры

В следующем примере кода вызывается CreateUser метод для создания нового пользователя членства. Если создание пользователя завершается сбоем MembershipCreateUserException , возникает исключение . Если исключение не MembershipCreateUserExceptionявляется , перехваченное исключение предоставляется как InnerException исключение создаваемого 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

Комментарии

Экземпляр MembershipCreateUserException класса создается методом , Membership.CreateUser когда пользователь не создан.

Эту перегрузку конструктора можно использовать для MembershipCreateUserException предоставления сведений о перехватываемом исключении, которое произошло во время создания пользователя.

См. также раздел

• Общие сведения о членстве в ASP.NET