UserPrincipal.FindByIdentity Méthode

Définition

Espace de noms:

System.DirectoryServices.AccountManagement

Assembly:

System.DirectoryServices.AccountManagement.dll

Paquet:

System.DirectoryServices.AccountManagement v8.0.0

Retourne un objet principal utilisateur qui correspond à la valeur d’identité spécifiée.

Surcharges

FindByIdentity(PrincipalContext, IdentityType, String)	Retourne un objet Principal de l’utilisateur qui correspond au type et à la valeur d’identité spécifiés. Cette version de la méthode FindByIdentity détermine le format de la valeur d’identité.
FindByIdentity(PrincipalContext, String)	Retourne un objet principal utilisateur qui correspond à la valeur d’identité spécifiée.

FindByIdentity(PrincipalContext, IdentityType, String)

Source:

User.cs

Retourne un objet Principal de l’utilisateur qui correspond au type et à la valeur d’identité spécifiés. Cette version de la méthode FindByIdentity détermine le format de la valeur d’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

Paramètres

context

PrincipalContext

Le PrincipalContext qui spécifie le serveur ou le domaine sur lequel les opérations sont exécutées.

identityType

IdentityType

Valeur d’énumération IdentityType qui spécifie le format du paramètre identityValue.

identityValue

String

L’identité du principal de l’utilisateur. Ce paramètre peut avoir n’importe quel format contenu dans l’énumération IdentityType.

Retours

UserPrincipal

Objet UserPrincipal qui correspond à la valeur et au type d’identité spécifiés ou qui a la valeur Null si aucune correspondance n’est trouvée.

Exceptions

MultipleMatchesException

Plusieurs objets Principal de l’utilisateur correspondant à l’objet Utilisateur actuel ont été trouvés.

InvalidEnumArgumentException

La valeur d’identité n’est pas une valeur d’énumération IdentityType valide.

Exemples

Le code suivant se connecte au magasin de l’ordinateur local. Étant donné que les informations d’identification ne sont pas spécifiées dans le PrincipalContext constructeur, les informations d’identification de l’utilisateur exécutant le thread actuel sont utilisées.

Une recherche est effectuée pour rechercher l’utilisateur qui a SamAccountName « Guest ».

Si l’utilisateur est trouvé, une case activée est effectuée pour déterminer si le compte de cet utilisateur est activé. Si le compte n’est pas activé, l’exemple de code l’active.

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

Retourne un objet principal utilisateur qui correspond à la valeur d’identité spécifiée.

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

Paramètres

context

PrincipalContext

Le PrincipalContext qui spécifie le serveur ou le domaine sur lequel les opérations sont exécutées.

identityValue

String

L’identité du principal de l’utilisateur. Ce paramètre peut avoir n’importe quel format contenu dans l’énumération IdentityType.

Retours

UserPrincipal

Objet UserPrincipal qui correspond à la valeur d’identité spécifiée ou qui a la valeur Null si aucune correspondance n’est trouvée.

Exceptions

MultipleMatchesException

Plusieurs objets Principal de l’utilisateur correspondant à l’objet Utilisateur actuel ont été trouvés.