ActiveDirectoryMembershipProvider.GetUser 方法

定義

命名空間:

System.Web.Security

組件:

System.Web.dll

取得 Active Directory 資料存放區中成員資格使用者的資訊。

多載

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

MembershipUser 執行個體，表示指定的使用者。 如果在 Active Directory 資料存放區中找不到指定之 username 值的使用者，則會傳回 null。

例外狀況

ArgumentException

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

-或-

username 包含逗號。

-或-

使用者名稱會對應到 userPrincipalName 屬性，且 username 參數會包含反斜線。

ArgumentNullException

username 為 null。

InvalidOperationException

GetUser(String, Boolean) 方法的呼叫，會在初始化 ActiveDirectoryMembershipProvider 執行個體之前進行。

備註

類別 GetUser 會呼叫 方法， Membership 以從 Active Directory 資料存放區擷取指定使用者的相關信息。

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

會修剪 username 參數值中的前置空格和後端空格。

另請參閱

• ASP.NET 成員資格簡介

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

MembershipUser 執行個體，表示指定的使用者。 如果在 Active Directory 資料存放區中找不到指定之 providerUserKey 值的使用者，則會傳回 null。

例外狀況

InvalidOperationException

GetUser(Object, Boolean) 方法的呼叫，會在初始化 ActiveDirectoryMembershipProvider 執行個體之前進行。

ArgumentException

providerUserKey 不是 SecurityIdentifier型別。

ArgumentNullException

providerUserKey 為 null。

備註

類別 GetUser 會呼叫 方法， Membership 以從 Active Directory 資料存放區擷取指定使用者的相關信息。

搜尋會尋找屬性符合 providerUserKey 參數的用戶實例objectSID。

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