UserPrincipal.FindByIdentity Metodo

Definizione

Spazio dei nomi:

System.DirectoryServices.AccountManagement

Assembly:

System.DirectoryServices.AccountManagement.dll

Pacchetto:

System.DirectoryServices.AccountManagement v8.0.0

Restituisce un oggetto entità utente che corrisponde al valore di identità specificato.

Overload

FindByIdentity(PrincipalContext, IdentityType, String)	Restituisce un oggetto entità utente che corrisponde al tipo e al valore di identità specificati. Questa versione del metodo FindByIdentity determina il formato del valore di identità.
FindByIdentity(PrincipalContext, String)	Restituisce un oggetto entità utente che corrisponde al valore di identità specificato.

FindByIdentity(PrincipalContext, IdentityType, String)

Source:

User.cs

Restituisce un oggetto entità utente che corrisponde al tipo e al valore di identità specificati. Questa versione del metodo FindByIdentity determina il formato del valore di identità.

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

Parametri

context

PrincipalContext

Oggetto PrincipalContext che specifica il server o il dominio su cui vengono eseguite le operazioni.

identityType

IdentityType

Valore di enumerazione IdentityType che specifica il formato del parametro identityValue.

identityValue

String

Identità dell'entità utente. Questo parametro può avere qualsiasi formato contenuto nell'enumerazione IdentityType.

Restituisce

UserPrincipal

Oggetto UserPrincipal che corrisponde al valore e al tipo di identità specificati oppure a Null se non viene trovata alcuna corrispondenza.

Eccezioni

MultipleMatchesException

Sono stati trovati più oggetti entità utente che corrispondono all'oggetto utente corrente.

InvalidEnumArgumentException

Il valore di identità non è un valore di enumerazione IdentityType valido.

Esempio

Il codice seguente si connette all'archivio computer locale. Poiché le credenziali non vengono specificate nel PrincipalContext costruttore, vengono usate le credenziali dell'utente che esegue il thread corrente.

Viene eseguita una ricerca per trovare l'utente con SamAccountName "Guest".

Se l'utente viene trovato, viene eseguito un controllo per determinare se l'account dell'utente è abilitato. Se l'account non è abilitato, il codice di esempio lo abilita.

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

Restituisce un oggetto entità utente che corrisponde al valore di identità specificato.

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

Parametri

context

PrincipalContext

Oggetto PrincipalContext che specifica il server o il dominio su cui vengono eseguite le operazioni.

identityValue

String

Identità dell'entità utente. Questo parametro può avere qualsiasi formato contenuto nell'enumerazione IdentityType.

Restituisce

UserPrincipal

Oggetto UserPrincipal che corrisponde al valore di identità specificato oppure a Null se non viene trovata alcuna corrispondenza.

Eccezioni

MultipleMatchesException

Sono stati trovati più oggetti entità utente che corrispondono all'oggetto utente corrente.