UserPrincipal.FindByIdentity Metodo

Definizione

Spazio dei nomi:: System.DirectoryServices.AccountManagement

Assembly:: System.DirectoryServices.AccountManagement.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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

Overload

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

FindByIdentity(PrincipalContext, IdentityType, String)

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

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

Il PrincipalContext che specifica il server o il dominio in cui vengono eseguite le operazioni.

identityType: IdentityType

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

identityValue: String

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

Valori restituiti

UserPrincipal

Oggetto UserPrincipal che corrisponde al valore di identità e al tipo specificati oppure null se non vengono trovate corrispondenze.

Eccezioni

MultipleMatchesException

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

InvalidEnumArgumentException

Il valore Identity non è un valore di enumerazione valido IdentityType .

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)
        usr.Enabled = true;

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

Si applica a

FindByIdentity(PrincipalContext, String)