ActiveDirectoryMembershipProvider.UpdateUser(MembershipUser) 方法

  • 參考

定義

命名空間:
System.Web.Security
組件:
System.Web.dll

更新 Active Directory 資料存放區中使用者的相關資訊。

public:
 override void UpdateUser(System::Web::Security::MembershipUser ^ user);
public override void UpdateUser (System.Web.Security.MembershipUser user);
override this.UpdateUser : System.Web.Security.MembershipUser -> unit
Public Overrides Sub UpdateUser (user As MembershipUser)

參數

user
MembershipUser

MembershipUser 執行個體，表示要更新的使用者，以及該使用者的更新資訊。

例外狀況

InvalidOperationException

UpdateUser(MembershipUser) 方法的呼叫，會在初始化 ActiveDirectoryMembershipProvider 執行個體之前進行。

ArgumentNullException

user 為 null。

-或-

RequiresUniqueEmail 屬性為 true，但提供之 MembershipUser 執行個體中的電子郵件地址為 null。

ArgumentException

Email 屬性在修剪後是空的。

-或-

Email 屬性超過 256 個字元。

-或-

Comment 屬性超過 1024 個字元。

-或-

Comment 屬性是空的。

-或-

提供之 MembershipUser 執行個體中的使用者名稱是空的，或超過使用者名稱所允許的最大長度 (通常為 256 個字元)。

-或-

提供之 MembershipUser 執行個體中的使用者名稱包含逗號。

-或-

使用者名稱對應至 userPrincipalName，但提供之 MembershipUser 執行個體中的使用者名稱包含反斜線。

ProviderException

在 Active Directory 資料存放區中找不到指定的使用者。

-或-

RequiresUniqueEmail 屬性為 true，且 Email 屬性的新值與現有的電子郵件地址重複。

備註

類別會呼叫 Membership 這個方法，以更新 Active Directory 資料存放區中的使用者資訊。 指定的 Email 成員資格使用者會更新 、 Comment 和 IsApproved 屬性值。 系統會忽略所有其他屬性。

參數的最大 username 長度為 256 個字元。 屬性的最大 Email 長度為 256 個字元。

無法使用 方法來更新 UpdateUser 成員資格使用者的密碼。 若要更新成員資格使用者的密碼，請使用 ChangePassword 方法。

提供者會使用從連接字串中指定的搜尋點開始的子樹搜尋。 ActiveDirectoryMembershipProvider如需連接字串的詳細資訊，請參閱 類別主題。

適用於

另請參閱