UserPrincipal.FindByIdentity Metodo
Definizione
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 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.