ActiveDirectoryMembershipProvider.GetUser 方法

参考

定义

命名空间:: System.Web.Security

程序集:: System.Web.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

获取 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。