ActiveDirectoryMembershipProvider.GetUser 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
從 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 課程主題。