UserPrincipal.FindByIdentity Yöntem

Tanım

Ad Alanı:

System.DirectoryServices.AccountManagement

Bütünleştirilmiş Kod:

System.DirectoryServices.AccountManagement.dll

Paket:

System.DirectoryServices.AccountManagement v8.0.0

Belirtilen kimlik değeriyle eşleşen bir kullanıcı asıl nesnesi döndürür.

Aşırı Yüklemeler

FindByIdentity(PrincipalContext, IdentityType, String)	Belirtilen kimlik türü ve değeriyle eşleşen bir kullanıcı asıl nesnesi döndürür. Yöntemin FindByIdentity bu sürümü kimlik değerinin biçimini belirler.
FindByIdentity(PrincipalContext, String)	Belirtilen kimlik değeriyle eşleşen bir kullanıcı asıl nesnesi döndürür.

FindByIdentity(PrincipalContext, IdentityType, String)

Kaynak:

User.cs

Belirtilen kimlik türü ve değeriyle eşleşen bir kullanıcı asıl nesnesi döndürür. Yöntemin FindByIdentity bu sürümü kimlik değerinin biçimini belirler.

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

Parametreler

context

PrincipalContext

işlemlerin PrincipalContext gerçekleştirildiği sunucuyu veya etki alanını belirten.

identityType

IdentityType

IdentityType Parametrenin biçimini identityValue belirten bir numaralandırma değeri.

identityValue

String

Kullanıcı sorumlusunun kimliği. Bu parametre, numaralandırmada IdentityType yer alan herhangi bir biçim olabilir.

Döndürülenler

UserPrincipal

UserPrincipal Belirtilen kimlik değeri ve türüyle eşleşen bir nesne veya eşleşme bulunmazsa null.

Özel durumlar

MultipleMatchesException

Geçerli kullanıcı nesnesiyle eşleşen birden çok kullanıcı asıl nesnesi bulundu.

InvalidEnumArgumentException

Kimlik değeri geçerli IdentityType bir numaralandırma değeri değil.

Örnekler

Aşağıdaki kod yerel bilgisayar deposuna bağlanır. Oluşturucuda kimlik bilgileri belirtilmediğinden PrincipalContext , geçerli iş parçacığını çalıştıran kullanıcının kimlik bilgileri kullanılır.

SamAccountName "Konuk" olan kullanıcıyı bulmak için bir arama gerçekleştirilir.

Kullanıcı bulunursa, bu kullanıcının hesabının etkinleştirilip etkinleştirilmediğini belirlemek için bir denetim gerçekleştirilir. Hesap etkinleştirilmemişse örnek kod bunu etkinleştirir.

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)

Kaynak:

User.cs

Belirtilen kimlik değeriyle eşleşen bir kullanıcı asıl nesnesi döndürür.

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

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

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

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

Parametreler

context

PrincipalContext

işlemlerin PrincipalContext gerçekleştirildiği sunucuyu veya etki alanını belirten.

identityValue

String

Kullanıcı sorumlusunun kimliği. Bu parametre, numaralandırmada IdentityType yer alan herhangi bir biçim olabilir.

Döndürülenler

UserPrincipal

UserPrincipal Belirtilen kimlik değeriyle eşleşen bir nesne veya eşleşme bulunmazsa null.

Özel durumlar

MultipleMatchesException

Geçerli kullanıcı nesnesiyle eşleşen birden çok kullanıcı asıl nesnesi bulundu.