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如需連接字串的詳細資訊，請參閱 類別主題。

另請參閱

• ASP.NET 成員資格簡介