UserPrincipal.FindByIdentity Metoda

Definice

Obor názvů:

System.DirectoryServices.AccountManagement

Sestavení:

System.DirectoryServices.AccountManagement.dll

Balíček:

System.DirectoryServices.AccountManagement v8.0.0

Vrátí objekt zabezpečení uživatele, který odpovídá zadané hodnotě identity.

Přetížení

FindByIdentity(PrincipalContext, IdentityType, String)	Vrátí objekt objektu zabezpečení uživatele, který odpovídá zadanému typu identity a hodnotě. Tato verze FindByIdentity metody určuje formát hodnoty identity.
FindByIdentity(PrincipalContext, String)	Vrátí objekt zabezpečení uživatele, který odpovídá zadané hodnotě identity.

FindByIdentity(PrincipalContext, IdentityType, String)

Zdroj:

User.cs

Vrátí objekt objektu zabezpečení uživatele, který odpovídá zadanému typu identity a hodnotě. Tato verze FindByIdentity metody určuje formát hodnoty 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

Parametry

context

PrincipalContext

Určuje PrincipalContext server nebo doménu, se kterou se operace provádějí.

identityType

IdentityType

Hodnota IdentityType výčtu, která určuje formát parametru identityValue .

identityValue

String

Identita objektu zabezpečení uživatele. Tento parametr může být libovolný formát, který je obsažen ve výčtu IdentityType .

Návraty

UserPrincipal

Objekt UserPrincipal , který odpovídá zadané hodnotě a typu identity, nebo null, pokud nejsou nalezeny žádné shody.

Výjimky

MultipleMatchesException

Bylo nalezeno více objektů zabezpečení uživatele odpovídajících aktuálnímu objektu uživatele.

InvalidEnumArgumentException

Hodnota identity není platná IdentityType hodnota výčtu.

Příklady

Následující kód se připojí k úložišti místního počítače. Vzhledem k tomu, že přihlašovací údaje nejsou zadány PrincipalContext v konstruktoru, použijí se přihlašovací údaje uživatele, který spouští aktuální vlákno.

Vyhledávání se provede za účelem vyhledání uživatele, který má SamAccountName Host.

Pokud je uživatel nalezen, provede se kontrola, která určí, jestli je účet tohoto uživatele povolený. Pokud účet není povolený, povolí ho ukázkový kód.

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)

Zdroj:

User.cs

Vrátí objekt zabezpečení uživatele, který odpovídá zadané hodnotě identity.

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

Parametry

context

PrincipalContext

Určuje PrincipalContext server nebo doménu, se kterou se operace provádějí.

identityValue

String

Identita objektu zabezpečení uživatele. Tento parametr může být libovolný formát, který je obsažen ve výčtu IdentityType .

Návraty

UserPrincipal

Objekt UserPrincipal , který odpovídá zadané hodnotě identity, nebo null, pokud nejsou nalezeny žádné shody.

Výjimky

MultipleMatchesException

Bylo nalezeno více objektů zabezpečení uživatele odpovídajících aktuálnímu objektu uživatele.