PrincipalCollection.Add Metoda

Definicja

Dodaje określony podmiot zabezpieczeń do końca kolekcji.Adds the specified principal to the end of the collection.

Przeciążenia

Add(ComputerPrincipal)

Dodaje określony obiekt ComputerPrincipal na końcu kolekcji.Adds the specified ComputerPrincipal object to the end of the collection.

Add(GroupPrincipal)

Dodaje określony obiekt GroupPrincipal na końcu kolekcji.Adds the specified GroupPrincipal object to the end of the collection.

Add(Principal)

Dodaje określony obiekt Principal na końcu kolekcji.Adds the specified Principal object to the end of the collection.

Add(UserPrincipal)

Dodaje określony obiekt UserPrincipal na końcu kolekcji.Adds the specified UserPrincipal object to the end of the collection.

Add(PrincipalContext, IdentityType, String)

Wyszukuje obiekt Principal pasujący do parametrów i dodaje go na końcu kolekcji.Searches for a Principal object that matches the parameters, and adds it to the end of the collection.

Uwagi

Podobnie jak w przypadku Remove i Contains, istnieją cztery przeciążenia tej funkcji, ale wszystkie te czynności wykonują tę samą czynność.As with Remove and Contains, There are four overloads to this function, but they all do the same thing. Dodatkowe przeciążenia są implementowane tylko w celu poprawy użyteczności, dzięki czemu deweloperzy korzystający z technologii IntelliSense zobaczą przeciążenia przyjmujące UserPrincipal, GroupPrincipallub ComputerPrincipal obiektu.The extra overloads are only implemented to improve usability, so that developers using IntelliSense see overloads that take a UserPrincipal, GroupPrincipal, or ComputerPrincipal object. Wywołanie jednego z przeciążeń użytkownika, grupy lub komputera jest dokładnie równoważne do wywołania przeciążenia Principal.Calling any one of the User, Group, or Computer overloads is exactly equivalent to calling the Principal overload.

Add(ComputerPrincipal)

Dodaje określony obiekt ComputerPrincipal na końcu kolekcji.Adds the specified ComputerPrincipal object to the end of the collection.

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
Public Sub Add (computer As ComputerPrincipal)

Parametry

computer
ComputerPrincipal

Element ComputerPrincipal obiektu.A ComputerPrincipal object.

Atrybuty

Uwagi

Ta funkcja może zgłosić następujące wyjątki:This function can throw the following exceptions:

WyjątekException OpisDescription
PrincipalExistsException computer już istnieje w kolekcji.computer already exists in the collection.

Add(GroupPrincipal)

Dodaje określony obiekt GroupPrincipal na końcu kolekcji.Adds the specified GroupPrincipal object to the end of the collection.

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
Public Sub Add (group As GroupPrincipal)

Parametry

group
GroupPrincipal

Element ComputerPrincipal obiektu.A ComputerPrincipal object.

Atrybuty

Uwagi

Ta funkcja może zgłosić następujące wyjątki:This function can throw the following exceptions:

WyjątekException OpisDescription
PrincipalExistsException group już istnieje w kolekcji.group already exists in the collection.

Add(Principal)

Dodaje określony obiekt Principal na końcu kolekcji.Adds the specified Principal object to the end of the collection.

public:
 virtual 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

Parametry

principal
Principal

Element Principal obiektu.A Principal object.

Implementuje

Atrybuty

Uwagi

Ta funkcja może zgłosić następujące wyjątki:This function can throw the following exceptions:

WyjątekException OpisDescription
PrincipalExistsException principal już istnieje w kolekcji.principal already exists in the collection.

Add(UserPrincipal)

Dodaje określony obiekt UserPrincipal na końcu kolekcji.Adds the specified UserPrincipal object to the end of the collection.

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
Public Sub Add (user As UserPrincipal)

Parametry

Atrybuty

Uwagi

Ta funkcja może zgłosić następujące wyjątki:This function can throw the following exceptions:

WyjątekException OpisDescription
PrincipalExistsException user już istnieje w kolekcji.user already exists in the collection.

Add(PrincipalContext, IdentityType, String)

Wyszukuje obiekt Principal pasujący do parametrów i dodaje go na końcu kolekcji.Searches for a Principal object that matches the parameters, and adds it to the end of the collection.

public:
 void Add(System::DirectoryServices::AccountManagement::PrincipalContext ^ context, System::DirectoryServices::AccountManagement::IdentityType identityType, System::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

Parametry

context
PrincipalContext

Obiekt PrincipalContext podmiotu zabezpieczeń, który ma zostać dodany do kolekcji.The PrincipalContext object for the principal to be added to the collection.

identityType
IdentityType

Obiekt IdentityType, który określa format identityValueAn IdentityType object that specifies the format of identityValue

identityValue
String

Ciąg, który identyfikuje podmiot zabezpieczeń w formacie określonym przez identityTypeA string that identifies the principal, in the format specified by identityType

Atrybuty

Uwagi

Ta funkcja może zgłosić następujące wyjątki:This function can throw the following exceptions:

WyjątekException OpisDescription
PrincipalExistsException Podmiot zabezpieczeń pasujący do tych parametrów już istnieje w kolekcji.The principal matching these parameters already exists in the collection.
NoMatchingPrincipalException Nie znaleziono podmiotu pasującego do określonych parametrów.No principal matching the specified parameters was found.
MultipleMatchesException Więcej niż jeden podmiot zabezpieczeń pasuje do określonych parametrów.More than one principal matches the specified parameters.
ArgumentException identityType jest ciągiem pustymidentityType is an empty string

Dotyczy