語言

ActiveDirectoryMembershipProvider.GetUser 方法

定義

從 Active Directory 資料儲存庫中的成員使用者取得資訊。

多載

名稱 Description
GetUser(String, Boolean)

取得與指定使用者名稱相關的會員使用者資訊。

GetUser(Object, Boolean)

取得與指定使用者金鑰相關的會員使用者資訊。

GetUser(String, Boolean)

取得與指定使用者名稱相關的會員使用者資訊。

public:
 override System::Web::Security::MembershipUser ^ GetUser(System::String ^ username, bool userIsOnline);
public override System.Web.Security.MembershipUser GetUser(string username, bool userIsOnline);
override this.GetUser : string * bool -> System.Web.Security.MembershipUser
Public Overrides Function GetUser (username As String, userIsOnline As Boolean) As MembershipUser

參數

username
String

使用者的名字,以獲取資訊。

userIsOnline
Boolean

此 GetUser(String, Boolean) 方法忽略此參數。

傳回

指定為 MembershipUser 代表使用者的實例。 若Active Directory資料庫中找不到指定 username 值的使用者,則回傳 null。

例外狀況

username 為空,或超過使用者名稱的最大長度(通常為 256 字元)。

-或-

username 包含逗號。

-或-

使用者名稱會映射到屬性, userPrincipalName 參數 username 包含反斜線。

username 是 null。

備註

GetUser 方法由 Membership 類別呼叫,從 Active Directory 資料儲存庫中擷取指定使用者的資訊。

提供者從連接字串指定的搜尋點開始,使用子樹搜尋。 有關連接字串的更多資訊,請參見 ActiveDirectoryMembershipProvider 課程主題。

參數值中會裁掉 username 前置與後置空格。

另請參閱

適用於

GetUser(Object, Boolean)

取得與指定使用者金鑰相關的會員使用者資訊。

public:
 override System::Web::Security::MembershipUser ^ GetUser(System::Object ^ providerUserKey, bool userIsOnline);
public override System.Web.Security.MembershipUser GetUser(object providerUserKey, bool userIsOnline);
override this.GetUser : obj * bool -> System.Web.Security.MembershipUser
Public Overrides Function GetUser (providerUserKey As Object, userIsOnline As Boolean) As MembershipUser

參數

providerUserKey
Object

使用者的唯一識別碼。

userIsOnline
Boolean

此 GetUser(Object, Boolean) 方法忽略此參數。

傳回

指定為 MembershipUser 代表使用者的實例。 若Active Directory資料庫中找不到指定 providerUserKey 值的使用者,則回傳 null。

例外狀況

providerUserKey 不屬於 SecurityIdentifier類型。

providerUserKey 是 null。

備註

GetUser 方法由 Membership 類別呼叫,從 Active Directory 資料儲存庫中擷取指定使用者的資訊。

搜尋會尋找屬性 objectSID 與參數相符 providerUserKey 的使用者實例。

提供者從連接字串指定的搜尋點開始,使用子樹搜尋。 有關連接字串的更多資訊,請參見 ActiveDirectoryMembershipProvider 課程主題。

適用於