Bagikan melalui

PrincipalCollection.Add Metode

  • Referensi

Definisi

Ruang nama:
System.DirectoryServices.AccountManagement
Rakitan:
System.DirectoryServices.AccountManagement.dll
Paket:
System.DirectoryServices.AccountManagement v6.0.0
Paket:
System.DirectoryServices.AccountManagement v7.0.0
Paket:
System.DirectoryServices.AccountManagement v8.0.0
Paket:
System.DirectoryServices.AccountManagement v9.0.0-preview.2.24128.5

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
Sumber:
PrincipalCollection.cs
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);
[System.Security.SecurityCritical]
public void Add (System.DirectoryServices.AccountManagement.ComputerPrincipal computer);
member this.Add : System.DirectoryServices.AccountManagement.ComputerPrincipal -> unit
[<System.Security.SecurityCritical>]
member this.Add : System.DirectoryServices.AccountManagement.ComputerPrincipal -> unit
Public Sub Add (computer As ComputerPrincipal)

Parameter

computer
ComputerPrincipal

Objek ComputerPrincipal.

Atribut
SecurityCriticalAttribute

Keterangan

Fungsi ini dapat melemparkan pengecualian berikut:

Pengecualian Deskripsi
PrincipalExistsException computer sudah ada dalam koleksi.

Berlaku untuk

Add(GroupPrincipal)

Sumber:
PrincipalCollection.cs
Sumber:
PrincipalCollection.cs
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);
[System.Security.SecurityCritical]
public void Add (System.DirectoryServices.AccountManagement.GroupPrincipal group);
member this.Add : System.DirectoryServices.AccountManagement.GroupPrincipal -> unit
[<System.Security.SecurityCritical>]
member this.Add : System.DirectoryServices.AccountManagement.GroupPrincipal -> unit
Public Sub Add (group As GroupPrincipal)

Parameter

group
GroupPrincipal

Objek ComputerPrincipal.

Atribut
SecurityCriticalAttribute

Keterangan

Fungsi ini dapat melemparkan pengecualian berikut:

Pengecualian Deskripsi
PrincipalExistsException group sudah ada dalam koleksi.

Berlaku untuk

Add(Principal)

Sumber:
PrincipalCollection.cs
Sumber:
PrincipalCollection.cs
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);
[System.Security.SecurityCritical]
public void Add (System.DirectoryServices.AccountManagement.Principal principal);
abstract member Add : System.DirectoryServices.AccountManagement.Principal -> unit
override this.Add : System.DirectoryServices.AccountManagement.Principal -> unit
[<System.Security.SecurityCritical>]
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)
Atribut
SecurityCriticalAttribute

Keterangan

Fungsi ini dapat melemparkan pengecualian berikut:

Pengecualian Deskripsi
PrincipalExistsException principal sudah ada dalam koleksi.

Berlaku untuk

Add(UserPrincipal)

Sumber:
PrincipalCollection.cs
Sumber:
PrincipalCollection.cs
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);
[System.Security.SecurityCritical]
public void Add (System.DirectoryServices.AccountManagement.UserPrincipal user);
member this.Add : System.DirectoryServices.AccountManagement.UserPrincipal -> unit
[<System.Security.SecurityCritical>]
member this.Add : System.DirectoryServices.AccountManagement.UserPrincipal -> unit
Public Sub Add (user As UserPrincipal)

Parameter

user
UserPrincipal

Objek UserPrincipal.

Atribut
SecurityCriticalAttribute

Keterangan

Fungsi ini dapat melemparkan pengecualian berikut:

Pengecualian Deskripsi
PrincipalExistsException user sudah ada dalam koleksi.

Berlaku untuk

Add(PrincipalContext, IdentityType, String)

Sumber:
PrincipalCollection.cs
Sumber:
PrincipalCollection.cs
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);
[System.Security.SecurityCritical]
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
[<System.Security.SecurityCritical>]
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.

Atribut
SecurityCriticalAttribute

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

Berlaku untuk