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 ComputerPrincipal obiekt na końcu kolekcji.Adds the specified ComputerPrincipal object to the end of the collection.

Add(GroupPrincipal)

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

Add(Principal)

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

Add(UserPrincipal)

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

Add(PrincipalContext, IdentityType, String)

Wyszukuje Principal obiekt 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 programu 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 zwiększenia użyteczności, dzięki czemu deweloperzy korzystający z technologii IntelliSense zobaczą przeciążenia przyjmujące UserPrincipal GroupPrincipal obiekt, lub ComputerPrincipal .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 Principal przeciążenia.Calling any one of the User, Group, or Computer overloads is exactly equivalent to calling the Principal overload.

Add(ComputerPrincipal)

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

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)

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 computer już istnieje w kolekcji.computer already exists in the collection.

Dotyczy

Add(GroupPrincipal)

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

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)

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 group już istnieje w kolekcji.group already exists in the collection.

Dotyczy

Add(Principal)

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

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)

Parametry

principal
Principal

Obiekt Principal.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.

Dotyczy

Add(UserPrincipal)

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

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)

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.

Dotyczy

Add(PrincipalContext, IdentityType, String)

Wyszukuje Principal obiekt 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);
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)

Parametry

context
PrincipalContext

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

identityType
IdentityType

IdentityTypeObiekt, który określa formatidentityValueAn 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