UserPrincipal.FindByIdentity Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
- Source:
- User.cs
- 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.UserPrincipalPublic Shared Function FindByIdentity (context As PrincipalContext, identityType As IdentityType, identityValue As String) As UserPrincipalParamè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
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
Plusieurs objets Principal de l’utilisateur correspondant à l’objet Utilisateur actuel ont été trouvés.
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();
S’applique à
FindByIdentity(PrincipalContext, String)
- Source:
- User.cs
- Source:
- User.cs
- 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.UserPrincipalPublic Shared Function FindByIdentity (context As PrincipalContext, identityValue As String) As UserPrincipalParamè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
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
Plusieurs objets Principal de l’utilisateur correspondant à l’objet Utilisateur actuel ont été trouvés.
