MembershipCreateUserException Конструкторы
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Инициализирует новый экземпляр класса MembershipCreateUserException.
Перегрузки
| Имя | Описание |
|---|---|
| MembershipCreateUserException() |
Инициализирует новый экземпляр класса MembershipCreateUserException. |
| MembershipCreateUserException(String) |
Инициализирует новый экземпляр MembershipCreateUserException класса и задает Message свойство заданному |
| MembershipCreateUserException(MembershipCreateStatus) |
Инициализирует новый экземпляр MembershipCreateUserException класса с указанным StatusCode значением. |
| MembershipCreateUserException(SerializationInfo, StreamingContext) |
Инициализирует новый экземпляр MembershipCreateUserException класса с предоставленными сведениями сериализации и контекстом. |
| MembershipCreateUserException(String, Exception) |
Инициализирует новый экземпляр MembershipCreateUserException класса и задает |
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 , когда пользователь не создается.
См. также раздел
Применяется к
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 понятное описание причины исключения.
См. также раздел
Применяется к
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 .
См. также раздел
Применяется к
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.
См. также раздел
Применяется к
MembershipCreateUserException(String, Exception)
Инициализирует новый экземпляр MembershipCreateUserException класса и задает messageMessage свойство предоставленному и 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 об обнаруженном исключении, которое произошло во время создания пользователя.