PrincipalCollection.Add Metode

Definisi

Ruang nama:

System.DirectoryServices.AccountManagement

Rakitan:

System.DirectoryServices.AccountManagement.dll

Paket:

System.DirectoryServices.AccountManagement v8.0.0

Menambahkan prinsipal yang ditentukan ke akhir koleksi.

Overload

Add(ComputerPrincipal)	Menambahkan objek yang ditentukan ComputerPrincipal ke akhir koleksi.
Add(GroupPrincipal)	Menambahkan objek yang ditentukan GroupPrincipal ke akhir koleksi.
Add(Principal)	Menambahkan objek yang ditentukan Principal ke akhir koleksi.
Add(UserPrincipal)	Menambahkan objek yang ditentukan UserPrincipal ke akhir koleksi.
Add(PrincipalContext, IdentityType, String)	Principal Mencari objek yang cocok dengan parameter, dan menambahkannya ke akhir koleksi.

Keterangan

Remove Seperti halnya dan Contains, Ada empat kelebihan beban untuk fungsi ini, tetapi semuanya melakukan hal yang sama. Kelebihan beban ekstra hanya diimplementasikan untuk meningkatkan kegunaan, sehingga pengembang yang menggunakan IntelliSense melihat kelebihan beban yang mengambil UserPrincipalobjek , GroupPrincipal, atau ComputerPrincipal . Memanggil salah satu kelebihan beban Pengguna, Grup, atau Komputer sama persis dengan memanggil Principal kelebihan beban.

Add(ComputerPrincipal)

Sumber:

PrincipalCollection.cs

Menambahkan objek yang ditentukan ComputerPrincipal ke akhir koleksi.

public:
 void Add(System::DirectoryServices::AccountManagement::ComputerPrincipal ^ computer);

public void Add (System.DirectoryServices.AccountManagement.ComputerPrincipal computer);

member this.Add : System.DirectoryServices.AccountManagement.ComputerPrincipal -> unit

Public Sub Add (computer As ComputerPrincipal)

Parameter

computer

ComputerPrincipal

Objek ComputerPrincipal.

Keterangan

Fungsi ini dapat melemparkan pengecualian berikut:

Pengecualian	Deskripsi
PrincipalExistsException	computer sudah ada dalam koleksi.

Add(GroupPrincipal)

Sumber:

PrincipalCollection.cs

Menambahkan objek yang ditentukan GroupPrincipal ke akhir koleksi.

public:
 void Add(System::DirectoryServices::AccountManagement::GroupPrincipal ^ group);

public void Add (System.DirectoryServices.AccountManagement.GroupPrincipal group);

member this.Add : System.DirectoryServices.AccountManagement.GroupPrincipal -> unit

Public Sub Add (group As GroupPrincipal)

Parameter

group

GroupPrincipal

Objek ComputerPrincipal.

Keterangan

Fungsi ini dapat melemparkan pengecualian berikut:

Pengecualian	Deskripsi
PrincipalExistsException	group sudah ada dalam koleksi.

Add(Principal)

Sumber:

PrincipalCollection.cs

Menambahkan objek yang ditentukan Principal ke akhir koleksi.

public:
 virtual void Add(System::DirectoryServices::AccountManagement::Principal ^ principal);

public void Add (System.DirectoryServices.AccountManagement.Principal principal);

abstract member Add : System.DirectoryServices.AccountManagement.Principal -> unit
override this.Add : System.DirectoryServices.AccountManagement.Principal -> unit

Public Sub Add (principal As Principal)

Parameter

principal

Principal

Objek Principal.

Penerapan

Add(T)

Keterangan

Fungsi ini dapat melemparkan pengecualian berikut:

Pengecualian	Deskripsi
PrincipalExistsException	principal sudah ada dalam koleksi.

Add(UserPrincipal)

Sumber:

PrincipalCollection.cs

Menambahkan objek yang ditentukan UserPrincipal ke akhir koleksi.

public:
 void Add(System::DirectoryServices::AccountManagement::UserPrincipal ^ user);

public void Add (System.DirectoryServices.AccountManagement.UserPrincipal user);

member this.Add : System.DirectoryServices.AccountManagement.UserPrincipal -> unit

Public Sub Add (user As UserPrincipal)

Parameter

user

UserPrincipal

Objek UserPrincipal.

Keterangan

Fungsi ini dapat melemparkan pengecualian berikut:

Pengecualian	Deskripsi
PrincipalExistsException	user sudah ada dalam koleksi.

Add(PrincipalContext, IdentityType, String)

Sumber:

PrincipalCollection.cs

Principal Mencari objek yang cocok dengan parameter, dan menambahkannya ke akhir koleksi.

public:
 void Add(System::DirectoryServices::AccountManagement::PrincipalContext ^ context, System::DirectoryServices::AccountManagement::IdentityType identityType, System::String ^ identityValue);

public void Add (System.DirectoryServices.AccountManagement.PrincipalContext context, System.DirectoryServices.AccountManagement.IdentityType identityType, string identityValue);

member this.Add : System.DirectoryServices.AccountManagement.PrincipalContext * System.DirectoryServices.AccountManagement.IdentityType * string -> unit

Public Sub Add (context As PrincipalContext, identityType As IdentityType, identityValue As String)

Parameter

context

PrincipalContext

Objek PrincipalContext untuk prinsipal yang akan ditambahkan ke koleksi.

identityType

IdentityType

Objek IdentityType yang menentukan format identityValue.

identityValue

String

String yang mengidentifikasi prinsipal, dalam format yang ditentukan oleh identityType.

Keterangan

Fungsi ini dapat melemparkan pengecualian berikut:

Pengecualian	Deskripsi
PrincipalExistsException	Perwakilan yang cocok dengan parameter ini sudah ada dalam koleksi.
NoMatchingPrincipalException	Tidak ada perwakilan yang cocok dengan parameter yang ditentukan yang ditemukan.
MultipleMatchesException	Lebih dari satu prinsipal cocok dengan parameter yang ditentukan.
ArgumentException	identityType adalah string kosong