UserPrincipal.FindByIdentity 方法

参考

定义

命名空间:: System.DirectoryServices.AccountManagement

程序集:: System.DirectoryServices.AccountManagement.dll

包:: System.DirectoryServices.AccountManagement v6.0.0

包:: System.DirectoryServices.AccountManagement v7.0.0

包:: System.DirectoryServices.AccountManagement v8.0.0

包:: System.DirectoryServices.AccountManagement v9.0.0-preview.2.24128.5

重要

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

返回与指定标识值相匹配的用户主体对象。

重载

FindByIdentity(PrincipalContext, IdentityType, String)	返回与指定标识类型相匹配的用户主体对象和值。此版本的 FindByIdentity 方法确定标识值的格式。
FindByIdentity(PrincipalContext, String)	返回与指定标识值相匹配的用户主体对象。

FindByIdentity(PrincipalContext, IdentityType, String)

Source:: User.cs

Source:: User.cs

Source:: User.cs

返回与指定标识类型相匹配的用户主体对象和值。此版本的 FindByIdentity 方法确定标识值的格式。

public:
 static System::DirectoryServices::AccountManagement::UserPrincipal ^ FindByIdentity(System::DirectoryServices::AccountManagement::PrincipalContext ^ context, System::DirectoryServices::AccountManagement::IdentityType identityType, System::String ^ identityValue);

public static System.DirectoryServices.AccountManagement.UserPrincipal FindByIdentity (System.DirectoryServices.AccountManagement.PrincipalContext context, System.DirectoryServices.AccountManagement.IdentityType identityType, string identityValue);

static member FindByIdentity : System.DirectoryServices.AccountManagement.PrincipalContext * System.DirectoryServices.AccountManagement.IdentityType * string -> System.DirectoryServices.AccountManagement.UserPrincipal

Public Shared Function FindByIdentity (context As PrincipalContext, identityType As IdentityType, identityValue As String) As UserPrincipal

参数

context: PrincipalContext

PrincipalContext，用于指定要对其执行操作的服务器或域。

identityType: IdentityType

IdentityType 枚举值，用于指定 identityValue 参数的格式。

identityValue: String

用户主体的标识。此参数的格式可以是 IdentityType 枚举中包含的任何格式。

UserPrincipal

与指定标识值和类型相匹配的 UserPrincipal 对象；若未找到匹配，则为 null。

例外

MultipleMatchesException

已找到多个与当前用户对象相匹配的用户主体对象。

InvalidEnumArgumentException

该标识值不是有效的 IdentityType 枚举值。

示例

以下代码连接到本地计算机存储区。由于构造函数中 PrincipalContext 未指定凭据，将使用运行当前线程的用户的凭据。

执行搜索以查找 SamAccountName 为“Guest”的用户。

如果找到该用户，将执行检查以确定此用户的帐户是否已启用。如果未启用帐户，示例代码将启用它。

PrincipalContext ctx = new PrincipalContext(ContextType.Machine);  

UserPrincipal usr = UserPrincipal.FindByIdentity(ctx,   
                                           IdentityType.SamAccountName,   
                                           "Guest");  

if(usr != null)  
{  
    if (usr.Enabled == false)  
        usr.Enabled = true;  

    usr.Save();  
    usr.Dispose();  
}  
ctx.Dispose();

适用于

FindByIdentity(PrincipalContext, String)

Source:: User.cs

Source:: User.cs

Source:: User.cs