Condividi tramite


UserPrincipal.FindByIdentity Metodo

Definizione

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
Source:
User.cs
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

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

Eccezioni

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

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();   

Si applica a

FindByIdentity(PrincipalContext, String)

Source:
User.cs
Source:
User.cs
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

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

Eccezioni

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

Si applica a