PrincipalCollection.Add Metoda

Definicja

Przestrzeń nazw:

System.DirectoryServices.AccountManagement

Zestaw:

System.DirectoryServices.AccountManagement.dll

Pakiet:

System.DirectoryServices.AccountManagement v8.0.0

Dodaje określonego podmiotu zabezpieczeń na końcu kolekcji.

Przeciążenia

Add(ComputerPrincipal)	Dodaje określony ComputerPrincipal obiekt na końcu kolekcji.
Add(GroupPrincipal)	Dodaje określony GroupPrincipal obiekt na końcu kolekcji.
Add(Principal)	Dodaje określony Principal obiekt na końcu kolekcji.
Add(UserPrincipal)	Dodaje określony UserPrincipal obiekt na końcu kolekcji.
Add(PrincipalContext, IdentityType, String)	Principal Wyszukuje obiekt zgodny z parametrami i dodaje go na końcu kolekcji.

Uwagi

Podobnie jak w przypadku Remove funkcji i Contains, istnieją cztery przeciążenia tej funkcji, ale wszystkie robią to samo. Dodatkowe przeciążenia są implementowane tylko w celu zwiększenia użyteczności, dzięki czemu deweloperzy korzystający z funkcji IntelliSense widzą przeciążenia, które przyjmują UserPrincipalobiekt , GroupPrincipallub ComputerPrincipal . Wywołanie dowolnego przeciążenia użytkownika, grupy lub komputera jest dokładnie równoważne wywołaniu Principal przeciążenia.

Add(ComputerPrincipal)

Źródło:

PrincipalCollection.cs

Dodaje określony ComputerPrincipal obiekt na końcu kolekcji.

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)

Parametry

computer

ComputerPrincipal

Obiekt ComputerPrincipal.

Uwagi

Ta funkcja może zgłaszać następujące wyjątki:

Wyjątek	Opis
PrincipalExistsException	computer już istnieje w kolekcji.

Add(GroupPrincipal)

Źródło:

PrincipalCollection.cs

Dodaje określony GroupPrincipal obiekt na końcu kolekcji.

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)

Parametry

group

GroupPrincipal

Obiekt ComputerPrincipal.

Uwagi

Ta funkcja może zgłaszać następujące wyjątki:

Wyjątek	Opis
PrincipalExistsException	group już istnieje w kolekcji.

Add(Principal)

Źródło:

PrincipalCollection.cs

Dodaje określony Principal obiekt na końcu kolekcji.

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)

Parametry

principal

Principal

Obiekt Principal.

Implementuje

Add(T)

Uwagi

Ta funkcja może zgłaszać następujące wyjątki:

Wyjątek	Opis
PrincipalExistsException	principal już istnieje w kolekcji.

Add(UserPrincipal)

Źródło:

PrincipalCollection.cs

Dodaje określony UserPrincipal obiekt na końcu kolekcji.

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)

Parametry

user

UserPrincipal

Obiekt UserPrincipal.

Uwagi

Ta funkcja może zgłaszać następujące wyjątki:

Wyjątek	Opis
PrincipalExistsException	user już istnieje w kolekcji.

Add(PrincipalContext, IdentityType, String)

Źródło:

PrincipalCollection.cs

Principal Wyszukuje obiekt zgodny z parametrami i dodaje go na końcu kolekcji.

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)

Parametry

context

PrincipalContext

Obiekt PrincipalContext podmiotu zabezpieczeń, który ma zostać dodany do kolekcji.

identityType

IdentityType

Obiekt IdentityType , który określa format identityValue.

identityValue

String

Ciąg identyfikujący podmiot zabezpieczeń w formacie określonym przez identityType.

Uwagi

Ta funkcja może zgłaszać następujące wyjątki:

Wyjątek	Opis
PrincipalExistsException	Podmiot zabezpieczeń pasujący do tych parametrów już istnieje w kolekcji.
NoMatchingPrincipalException	Nie znaleziono podmiotu zabezpieczeń pasującego do określonych parametrów.
MultipleMatchesException	Więcej niż jeden podmiot zabezpieczeń jest zgodny z określonymi parametrami.
ArgumentException	identityType jest pustym ciągiem