MembershipCreateUserException Konstruktor

Definisi

Ruang nama:

System.Web.Security

Rakitan:

System.Web.ApplicationServices.dll

Menginisialisasi instans baru kelas MembershipCreateUserException.

Overload

MembershipCreateUserException()	Menginisialisasi instans baru kelas MembershipCreateUserException.
MembershipCreateUserException(String)	Menginisialisasi instans MembershipCreateUserException baru kelas dan mengatur Message properti ke nilai parameter yang disediakan message .
MembershipCreateUserException(MembershipCreateStatus)	Menginisialisasi instans MembershipCreateUserException baru kelas dengan nilai yang ditentukan StatusCode .
MembershipCreateUserException(SerializationInfo, StreamingContext)	Menginisialisasi instans MembershipCreateUserException baru kelas dengan informasi dan konteks serialisasi yang disediakan.
MembershipCreateUserException(String, Exception)	Menginisialisasi instans MembershipCreateUserException baru kelas dan mengatur Message properti ke yang disediakan message dan InnerException properti ke yang disediakan innerException.

MembershipCreateUserException()

Menginisialisasi instans baru kelas MembershipCreateUserException.

public:
 MembershipCreateUserException();

public MembershipCreateUserException ();

Public Sub New ()

Contoh

Contoh kode berikut memanggil Membership.CreateUser metode untuk membuat pengguna keanggotaan baru. Jika pembuatan pengguna gagal, akan MembershipCreateUserException dilemparkan.

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

Keterangan

Instans MembershipCreateUserException kelas dilemparkan oleh Membership.CreateUser metode ketika pengguna tidak dibuat.

Lihat juga

• Pengantar Keanggotaan ASP.NET

MembershipCreateUserException(String)

Menginisialisasi instans MembershipCreateUserException baru kelas dan mengatur Message properti ke nilai parameter yang disediakan 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)

Parameter

message

String

Deskripsi alasan pengecualian.

Contoh

Contoh kode berikut memanggil Membership.CreateUser metode untuk membuat pengguna keanggotaan baru. Jika pembuatan pengguna gagal, dilemparkan MembershipCreateUserException dengan pesan berdasarkan yang StatusCode dikembalikan oleh CreateUser metode .

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

Keterangan

Kelas MembershipCreateUserException dilemparkan oleh Membership.CreateUser metode ketika pengguna tidak dibuat.

Anda dapat menggunakan message parameter untuk mengatur Message properti pengecualian ke deskripsi yang bermakna tentang alasan pengecualian.

Lihat juga

• Pengantar Keanggotaan ASP.NET

MembershipCreateUserException(MembershipCreateStatus)

Menginisialisasi instans MembershipCreateUserException baru kelas dengan nilai yang ditentukan 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)

Parameter

statusCode

MembershipCreateStatus

Nilai MembershipCreateStatus enumerasi yang menjelaskan alasan pengecualian.

Contoh

Contoh kode berikut memanggil CreateUser metode untuk membuat pengguna keanggotaan baru. Jika pembuatan pengguna gagal, akan MembershipCreateUserException dilemparkan dengan yang StatusCode dikembalikan oleh CreateUser metode .

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

Keterangan

Kelas MembershipCreateUserException dilemparkan oleh Membership.CreateUser metode ketika pengguna tidak dibuat.

Parameter statusCode memungkinkan Anda untuk menunjukkan mengapa MembershipCreateUserException dilemparkan. Nilai statusCode parameter diekspos oleh StatusCode properti .

Lihat juga

• Pengantar Keanggotaan ASP.NET

MembershipCreateUserException(SerializationInfo, StreamingContext)

Menginisialisasi instans MembershipCreateUserException baru kelas dengan informasi dan konteks serialisasi yang disediakan.

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

SerializationInfo yang menyimpan data objek berseri tentang pengecualian yang dilemparkan.

context

StreamingContext

StreamingContext yang berisi informasi kontekstual tentang sumber atau tujuan.

Contoh

Contoh kode berikut menunjukkan implementasi MembershipCreateUserException kelas yang memanggil konstruktor yang dilindungi dari kelas dasar dengan informasi dan konteks serialisasi yang disediakan.

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

Keterangan

Konstruktor ini dipanggil selama deserialisasi untuk menyusun ulang objek pengecualian yang ditransmisikan melalui aliran. Untuk informasi selengkapnya, lihat Serialisasi XML dan SOAP.

Lihat juga

• Pengantar Keanggotaan ASP.NET

MembershipCreateUserException(String, Exception)

Menginisialisasi instans MembershipCreateUserException baru kelas dan mengatur Message properti ke yang disediakan message dan InnerException properti ke yang disediakan 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)

Parameter

message

String

Deskripsi alasan pengecualian.

innerException

Exception

Pengecualian yang menyebabkan MembershipCreateUserException.

Contoh

Contoh kode berikut memanggil CreateUser metode untuk membuat pengguna keanggotaan baru. Jika pembuatan pengguna gagal, akan MembershipCreateUserException dilemparkan. Jika pengecualian bukan MembershipCreateUserException, pengecualian yang tertangkap disediakan sebagai InnerException dari MembershipCreateUserException yang dilemparkan.

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

Keterangan

Instans MembershipCreateUserException kelas dilemparkan oleh Membership.CreateUser metode ketika pengguna tidak dibuat.

Anda dapat menggunakan kelebihan beban MembershipCreateUserException konstruktor ini untuk memberikan informasi mengenai pengecualian yang tertangkap yang terjadi saat pengguna sedang dibuat.

Lihat juga

• Pengantar Keanggotaan ASP.NET