UserPrincipal.FindByIdentity Metode

Definisi

Ruang nama:

System.DirectoryServices.AccountManagement

Rakitan:

System.DirectoryServices.AccountManagement.dll

Paket:

System.DirectoryServices.AccountManagement v8.0.0

Mengembalikan objek utama pengguna yang cocok dengan nilai identitas yang ditentukan.

Overload

FindByIdentity(PrincipalContext, IdentityType, String)	Mengembalikan objek utama pengguna yang cocok dengan jenis identitas dan nilai yang ditentukan. Versi FindByIdentity metode ini menentukan format nilai identitas.
FindByIdentity(PrincipalContext, String)	Mengembalikan objek utama pengguna yang cocok dengan nilai identitas yang ditentukan.

FindByIdentity(PrincipalContext, IdentityType, String)

Sumber:

User.cs

Mengembalikan objek utama pengguna yang cocok dengan jenis identitas dan nilai yang ditentukan. Versi FindByIdentity metode ini menentukan format nilai identitas.

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

Parameter

context

PrincipalContext

PrincipalContext yang menentukan server atau domain tempat operasi dilakukan.

identityType

IdentityType

Nilai IdentityType enumerasi yang menentukan format identityValue parameter.

identityValue

String

Identitas prinsipal pengguna. Parameter ini dapat berupa format apa pun yang terkandung dalam IdentityType enumerasi.

Mengembalikan

UserPrincipal

Objek UserPrincipal yang cocok dengan nilai dan jenis identitas yang ditentukan, atau null jika tidak ada kecocokan yang ditemukan.

Pengecualian

MultipleMatchesException

Beberapa objek utama pengguna yang cocok dengan objek pengguna saat ini ditemukan.

InvalidEnumArgumentException

Nilai identitas bukan nilai enumerasi yang valid IdentityType .

Contoh

Kode berikut tersambung ke penyimpanan komputer lokal. Karena kredensial tidak ditentukan dalam PrincipalContext konstruktor, kredensial pengguna yang menjalankan utas saat ini digunakan.

Pencarian dilakukan untuk menemukan pengguna yang memiliki SamAccountName "Guest".

Jika pengguna ditemukan, pemeriksaan dilakukan untuk menentukan apakah akun pengguna ini diaktifkan. Jika akun tidak diaktifkan, kode contoh akan mengaktifkannya.

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)

Sumber:

User.cs

Mengembalikan objek utama pengguna yang cocok dengan nilai identitas yang ditentukan.

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

Parameter

context

PrincipalContext

PrincipalContext yang menentukan server atau domain tempat operasi dilakukan.

identityValue

String

Identitas prinsipal pengguna. Parameter ini dapat berupa format apa pun yang terkandung dalam IdentityType enumerasi.

Mengembalikan

UserPrincipal

Objek UserPrincipal yang cocok dengan nilai identitas yang ditentukan, atau null jika tidak ada kecocokan yang ditemukan.

Pengecualian

MultipleMatchesException

Beberapa objek utama pengguna yang cocok dengan objek pengguna saat ini ditemukan.