MembershipCreateUserException 建構函式

定義

命名空間:: System.Web.Security

組件:: System.Web.dll

組件:: System.Web.ApplicationServices.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

初始化 MembershipCreateUserException 類別的新執行個體。

多載

名稱	Description
MembershipCreateUserException()	初始化 MembershipCreateUserException 類別的新執行個體。
MembershipCreateUserException(String)	初始化該類別的新實例 MembershipCreateUserException ，並將屬性設 Message 為所提供的 `message` 參數值。
MembershipCreateUserException(MembershipCreateStatus)	初始化一個以指定MembershipCreateUserException值的新StatusCode類別實例。
MembershipCreateUserException(SerializationInfo, StreamingContext)	初始化一個新的類別實例 MembershipCreateUserException ，並附上所提供的序列化資訊與上下文。
MembershipCreateUserException(String, Exception)	初始化該類別的新實例 MembershipCreateUserException ，並將屬性設 Message 為 sprovided `message` ， InnerException 屬性設為 sprovided `innerException`。

MembershipCreateUserException()

初始化 MembershipCreateUserException 類別的新執行個體。

public:
 MembershipCreateUserException();

public MembershipCreateUserException();

Public Sub New ()

範例

以下程式碼範例呼叫 Membership.CreateUser 建立新成員使用者的方法。如果使用者建立失敗，就會拋出 a 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

備註

當使用者未被建立時，方法會拋出Membership.CreateUser該類別的MembershipCreateUserException實例。

另請參閱

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 建立新成員使用者的方法。若使用者建立失敗，會拋出 a MembershipCreateUserException 並根據方法回傳CreateUser的訊息StatusCode。

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 建立新成員使用者的方法。若使用者建立失敗，會拋出 a 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

the that 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 為 sprovided message ， InnerException 屬性設為 sprovided 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 建立新成員使用者的方法。如果使用者建立失敗，就會拋出 a 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

備註

當使用者未被建立時，方法會拋出Membership.CreateUser該類別的MembershipCreateUserException實例。

你可以利用建構子的 MembershipCreateUserException 過載，提供在使用者建立過程中發生的被抓異常的資訊。

另請參閱

ASP.NET 會員介紹

適用於

意見反應

此頁面對您有幫助嗎？

共用方式為

MembershipCreateUserException 建構函式

定義

多載

MembershipCreateUserException()

範例

備註

另請參閱

適用於

MembershipCreateUserException(String)

參數

範例

備註

另請參閱

適用於

MembershipCreateUserException(MembershipCreateStatus)

參數

範例

備註

另請參閱

適用於

MembershipCreateUserException(SerializationInfo, StreamingContext)

參數

範例

備註

另請參閱

適用於

MembershipCreateUserException(String, Exception)

參數

範例

備註

另請參閱

適用於

意見反應